VtxVisitOutEdgeClient 



Diagram 



Walk outgoing Edges 
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VtxVisitOutEdgeClient 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void^ VbcVisitOutEdgeQienK pVtx, offset, pBlk ) 

Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The VtxVisitOutEdgeClient function walks all the outgoing edges linked to the 
Vertex pVtx and calls an Edge client function for each edge visited. The Block 
pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
See Also 

VtxVisitEdge, VtxVisitEdgeClient, VtxVisitlnEdge, VtxVisitlnEdgeClient, 
VtxVisitOutEdge 
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VtxVisitOutEdge 



Diagram 



Walk outgoing Edges 
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VtxVisitOutEdge 



Summary 

#include "cobjects.h" 
#lnclude "vtxmac.h" 

Void VbcVisitOutEdge(pVtx,pBlk) 
PVTX pVtx; 
PBLK pBlk; 

Friend Function 

Purpose 

The VtxVisitOutEdge function walks all the outgoing edges linked to the Vertex 
pVtx and calls an Edge function for each edge visited. The Block pBlk contains 
the function and an optional list of arguments. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

Return Value 

No return value 
Notes 

The edge function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitEdgeClient, VtxVisitlnEdge, VtxVisitlnEdgeClient 
VtxVisitOutEdgeClient 
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VtxVisitlnEdgeClient 



Diagram 



Walk Incoming Edges 
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VtxVisitlnEdgeClient 



Summary 

#lnclude "cobjects.h" 
#include "vtxmac.h" 

Void VtxVisitlnEdgeClienK pVtx, offset, pBlk ) 

PVTX pVtx; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The VtxVisitlnEdgeClient function walks all the incoming edges linked to the 
Vertex pVtx and calls an Edge client function for each edge visted. The Block 
pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitEdgeClient, VtxVisitlnEdge, VtxVisitOutEdge, 
VtxVisitOutEdgeClient 
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VtxVisitlnEdge 



Diagram 



Walk Incoming Edges 
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VtxVisitlnEdge 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxVisitInEdge( pVtx, pBlk ) 

PVTX pVtx; 
PBLK pBlk; 

Friend Function 

Purpose 

The VtxVisitlnEdge function walks all the incoming edges linked to the Vertex 
pVtx and calls an Edge function for each edge visited. The Block pBlk contains 
the function and an optional list of arguments. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

Return Value 

No return value 

Notes 

The edge function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitEdgeClient, VtxVisitlnEdgeClient, VtxVisitOutEdge, 
VtxVisitOutEdgeClient 6 
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VtxVisitEdgeClient 



Diagram 



Walk all Edges 
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VtxVisitEdgeClient 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxVisitEdgeClienK pVtx, offset, pBlk ) 

PVTX pVtx; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The VtxVisitEdgeClient function walks all the client edges linked to the Vertex 
pVtx and calls an Edge client function for each edge visited. The Block pBlk 
contains the client function and an optional list of arguments. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitlnEdge, VtxVisitlnEdgeClient, VtxVisitOutEdge, 
VtxVisitOutEdgeClient ™ 
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VtxVisitEdge 



Diagram 



Walk all Edges 



Vtx-30 



I 

I 

ft 
I 

I 
1 
1 
1 
1 
1 
I 

I 
1 
1 
1 
1 
1 
i 
I 



VtxVisitEdge 



Summary 

#include "cotjects.h' 
#include "vtxmac.h" 



Void 

PVTX 

PBLK 



VtxVisitEdge( pVtx, pBlk ) 

pVtx; 

pBlk; 



Friend Function 

Purpose 

The VtxVisitEdge function walks all the edges linked to the Vertex pVtx and 
calls an Edge function for each edge visited. The Block pBlk contains the 
function and an optional list of arguments. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 



client function to call and any optional parameters to 
be sent to the function. 



Return Value 

No return value 

Notes 

The edge function may return a value but it is ignored. 
See Also 

VtxVisitEdgeClient, VtxVisitlnEdge, VtxVisitlnEdgeClie: 
VtxVisitOutEdgeClient 



pBlk 



Pointer to structure of 




e Block which contains the 
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VtxStackSetup 



Summary 

#include "cobjects.h' 
#lnclude "vtxmac.h" 



Void 
PVTX 



VtxStackSetup( pVtx, inStack, outStack, stackVtx, i ) 

pVtx; 



Mediumlnt 
Mediumlnt 
PVTX 



*inStack; 
*outStack; 
*stackVtx; 



Mediumlnt *i; 
Friend Function 

A macro Is available for this function 

Purpose 

The VtxStackSetup function is a private function used the Graph class. 
Return Value 

No return value 



This is a function only to be used by the Graph class and is used by the 
topological sort function. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use 
VtxStackSetup function. 



Notes 
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VtxSend Destroy 



Summary 

#include "cobjects.h' 
#include "vtxmac.h" 



Void 
PVTX 




Public Function 



Purpose 



The VtxSendDestroy function sends a message to the client of the Vertex pVtx 
asking it to destroy the vertex. The Vertex client function will receive this 
message and should deinitialize or destroy the vertex. This message function 
should be included in the Vertex client message array. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxSendDestroy function. 



Example 
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VtxInGrf 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Bool VtxInGrf(pVtx) 

PVTX pVtx; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxInGrf function determines If the Vertex pVtx is linked to a Graph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxInGrf function is True if the Vertex pVtx is linked 
to a Graph, otherwise False if returned. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxInGrf function. 
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Vtxlnit 



Summary 

#include "cobjects.h' 
#Include "vtxmac.h" 



Void 

PVTX 



VtxInit(pVtx) 

pVtx; 



Public Function 



Purpose 



The Vtxlnit function initializes the Vertex object. The Vtxlnit function should be 
the first function called when using the Vertex class. 

Parameter - Description 



Return Value 

No return value 

Notes 

The last function to call when using the Vertex class is VtxDelnit. 

See Also 

VtxDelnit, VtxDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Vtxlnit function. 



pVtx 



Pointer to a structure of type Vertex. 
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VtxGetGrf 



Summary 

#include "cobjects.h 
#include "vtxmac.h" 



PGRF 

PVTX 



VtxGetGrf(pVtx) 

pVtx; 



Friend Function 

A macro Is available for this function 



Purpose 



The VtxGetGrf function returns the a pointer to the graph that the Vertex pVtx 
is linked to. 



Return Value 

The return value from the VtxGetGrf function is a pointer to the Graph 
structure contained by the Vertex pVtx or NULL if not linked to a graph. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetGrf function. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 
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VtxGetFirstOut 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

PEDG VtxGetFirslOuK pVtx ) 

PVTX pVtx; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxGetFirstOut function returns the first outgoing Edge linked to the 
Vertex pVtx or NULL if none exist. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
Return Value 

The return value from the VtxGetFirstOut function is a pointer to an Edge 
structure or NULL. This edge is the first in a list of outgoing edges linked to the 
Vertex pVtx. w 

See Also 

VtxGetFirstln 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetFirstOut function. 
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VtxGetFirstln 



Summary 

#lnclude "cobjects.h" 
#include "vtxmac.h" 



PEDG 

PVTX 



VtxGetFirstIn( pVtx ) 

pVtx; 



Public Function 

A macro is available for this function 



Purpose 



The VtxGetFirstln function returns the first incoming Edge linked to the Vertex 
pVtx or NULL if none exist. 



Return Value 

The return value from the VtxGetFirstln function is a pointer to an Edge 
structure or NULL. This edge is the first in a list of incoming edges linked to 
the Vertex pVtx. 

See Also 

VtxGetFirstOut 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetFirstln function. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 
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VtxGetClient 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

POBJ VtxGetQient( pVtx, offset ) 

PVTX pVtx; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxGetClient function returns the client of the Vertex pVtx. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 
offset - The distance in bytes between the Vertex pVtx and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the VtxGetClient function is a pointer to the client of the 
Vertex pVtx. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetClient function. 
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VtxFindOutEdgClient 

Notes 

The client function should return True for the VtxFindOutEdgClient function to 
return True. 

The optional function will only be called if the edge links to the vertices pvtxl 
and pVtxO. 

See Also 

VtxFindOutEdg, EdgComparelnVtx 

Diagram 

Is pVtxO linked to my incoming Edge? 




Legend 



Vtx-20 



VtxFindOutEdgClient 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

POBJ VtxFindOutEdgClient( pVtxO, pVtxI, offset, pBlk ) 

PVTX pVtxO; 
PVTX pVtxI; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The VtxFindOutEdgeCllent function walks all the incoming edges linked to the 
Vertex pVtxI and returns the client of the edge that has the Vertex pVtxO, as an 
outgoing edge. If no edge exists NULL is returned. 

If the caller requires that the comparison should have additional criteria to 
linkage* an Edge client function can be given to call as the incoming edges are 
visited. If no function call is required a function NULL should be given. 

The Block pBlk contains the client function and an optional list of arguments. 
The function should return a boolean (True/False) value. 

Parameter - Description 



pVtxO - Pointer to a structure of type Vertex where this vertex 

has the search edge as an outgoing edge. 
pVtxI - Pointer to a structure of type Vertex where this vertex 

has the search edge as an mcoming edge, 
offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. " 

Return Value 

The return value from the VtxFindOutEdgClient function is a pointer to the 
Edge client structure for the edge that links to the vertices pVtxI and pVtxO. If 
no edge is found then NULL is returned. 
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VtxFindOutEdg 

Notes 

The function should return True for the VtxFindOutEdg function to return 
True. 

The optional function will only be called if the edge links to the vertices pVl 
and pVtxO. 

See Also 

VtxFindOutEdgClient, EdgComparelnVtx 

Diagram 



Is pVtxO linked to my incoming Edge? 




Legend 
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VtxFindOutEdg 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 



PEDG VtxFindOutEdg( pVtxO, pVtxI, offset, pBlk ) 

PVTX pVtxO; 

PVTX pVtxI; 

Mediumlnt offset; 

PBLK pBlk; 



Private Function 

Purpose 

The VtxFindOutEdge function walks all the incoming edges linked to the Vertex 
pVtxI and returns the edge that has the Vertex pVtxO, as an outgoing edge. If 
no edge exists NULL is returned. 

If the caller requires that the comparison should have additional criteria to 
linkage, an Edge client function can be given to call as the incoming edges are 
visited. If no function call is required a function NULL should be given. 

The Block pBlk contains the client function and an optional list of arguments. 
The function should return a boolean (True/False) value. 

Parameter - Description 



pVtxO - Pointer to a structure of type Vertex where this vertex 

has the search edge as an outgoing edge. 
pVtxI - Pointer to a structure of type Vertex where this vertex 

has the search edge as an incoming edge, 
offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the VtxFindOutEdg function is a pointer to an Edge 
structure. The edge returned is linked to the vertices pVtxI and pVtxO. If no 
edge is found then NULL is returned. 
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VtxDisconnectFromGrf 



Diagram 



Before 



First unlink Edges 
from Graph 




Vertex to unlink 
from Graph 
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VtxDisconnectFromGrf 



Summary 

#include "cobjects.h" 
#Include "vtxmac.h" 

Void VtxDisconnectFromGrf ( pVtx ) 

PVTX pVtx; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxDisconnectFromGrf function unlinks the Vertex pVtx from a Graph. The 
vertex must not have any linkage to edges. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
Return Value 

No return value 

Notes 

[pVtx must be linked to a graph.] 
[pVtx must have no edges.] 

See Also 

VtxConnectToGrf 
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VtxDestroy 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxDestroy( pVtx ) 

PVTX pVtx; 

Public Function 

Purpose 

The VtxDestroy function deallocates the memory used by the object and 
deinitializes the Vertex object. The Vertex pVtx should not be referenced after 
this function call since its memory will have been deallocated. 

Any vertices linked to pVtx will be unlinked and pVtx will also be unlinked 
from its graph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 

Notes 

[pVtx must not have a sub-object.] 
See Also 
VtxDelnit, Vtxlnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxDestroy function. 
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VtxDelnit 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxDeInit(pVtx) 
PVTX pVtx; 

Public Function 

Purpose 

The VtxDelnit function deinitializes the Vertex object. The VtxDelnit function 
should be the last function called when using the Vertex class. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 

Notes 

The first function to call when using the Vertex class is Vtxlnit. 

pVtx can be unlinked from its edges and the graph using the VtxClear 
function. 

[pVtx must have no edges.] 

[pVtx must not already be linked to a graph.] 

See Also 

VtxDestroy, Vtxlnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxDelnit function. 
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VtxCountOut 



Diagram 

Outgoing Edges = 2 




Legend 
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VtxCountOut 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Mediumlnt VtxCountOut( pVtx ) 
PVTX pVtx; 

Public Function 

A macro is available for this function 

Purpose 

The VtxCountOut function returns the number of outgoing edges that are 
linked to the Vertex pVtx. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxCountOut function is the number of outgoing 
edges from the Vertex pVtx. 

See Also 

VtxCountln 
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VtxCountln 

Diagram 

Incoming Edges = 3 




Legend 
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VtxCountln 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Mediumlnt VtxCountIn( pVtx ) 
PVTX pVtx; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxCountln function returns the number of incoming edges that are linked 
to the Vertex pVtx. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxCountln function is the number of incoming 
edges to the Vertex pVtx. 

See Also 

VtxCountOut 
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VtxConnectToGrf 



Diagram 
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VtxConnectToGrf 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxConnectToGrf(pVtx,pGrf ) 

PVTX pVtx; 
PGRF pGrf; 

Public Function 

Purpose 

The VtxConnectToGrf links the Vertex pVtx to the Graph pGrf. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
pGrf - Pointer to the Graph structure that the vertex will be 
linked to. 

Return Value 

No return value 

Notes 

[pVtx must not already be linked to a graph.] 
[pVtx must have no edges.] 
See Also 

VtxDisconnectFromGrf 
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VtxClear 



Summary 

#lnclude "cobjects.h' 
#include "vtxmac.h" 



Void 
PVTX 



Vtxaear(pVtx) 

pVtx; 



Public Function 



Purpose 



The VtxClear function unlinks the edges (if any) from the Vertex pVtx and also 
unlinks pVtx from the graph. The vertex will be in the same state as it was 
after being initialized. 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxClear function. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 
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VtxAsOutDII 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

PDLL VtxAsOutDlK pVtx ) 

PVTX pVtx; 

Friend Function 

Purpose 

The return value from the VtxAsOutDII function is a pointer to the List 
structure contained by the Vertex pVtx. The list contains the outgoing edges to 
pVtx. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxAsOutDII function is a pointer to the structure of 
type List contained by the Vertex class. The list contains the outgoing edges to 
pVtx. 

See Also 

VtxAsGrfLel, VtxAsInDll, VtxAsObj 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsOutDII function. 
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VtxAsObj 



Summary 

#include "cobjects.h" 
#lnclude "vtxmac.h" 

POBJ VtxAsObj(pVtx) 
PVTX pVtx; 

Private Function 

Purpose 

The VtxAsObj function returns a pointer to the Object structure contained by 
the Vertex pVtx. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxAsObj function is a pointer to the Object 
structure contained by the Vertex class. 

Notes 

The Object pointer can be used to send a message to the client of the vertex. 

See Also 

VtxAsGrfLel, VtxAsInDll, VtxAsOutDU 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsObj function. 
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VtxAslnDII 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 



PDLL 

PVTX 



VtxAsInDlK pVtx ) 

pVtx; 



Friend Function 



Purpose 



The return value from the VtxAslnDII function is a pointer to the List structure 
contained by the Vertex pVtx. The list contains the incoming edges to pVtx. 

Parameter - Description 



Return Value 

The return value from the VtxAslnDII function is a pointer to the structure of 
type List contained by the Vertex class. The list contains the incoming edges to 
pVtx. 

See Also 

VtxAsGrfLel, VtxAsObj, VtxAsOutDll 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAslnDII function. 



pVtx 



Pointer to a structure of type Vertex. 
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VtxAsGrfLel 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

PLEL VtxAsGrfLel(pVtx) 
PVTX pVtx; 

Friend Function 

A macro Is available for this function 

Purpose 

The VtxAsGrfLel function returns a pointer to the ListElement structure 
contained by the Vertex pVtx for linking to the graph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxAsGrfLel function is a pointer to the ListElement 
structure contained by the Vertex pVtx. 

See Also 

VtxAsInDll, VtxAsObj, VtxAsOutDll 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsGrfLel function. 
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Class Reference for Vertex 



Structure Name: 
Abbreviation: 
Class Type: 



Vertex 
Vtx 

Inheritable class 



Task 
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TskRaiseException 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C.TST5.C,TST6.C for an example of the use of the 
TskRaiseException function. 
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TskRaiseException 



Summary 

#include "cobjects.h" 
#lnclude "tskmac.h" 

Void TskRaiseException( pTsk, error ) 

PTSK pTsk; 
Mediumlnt error; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskRaiseException function raises an exception unconditionally for the 
Task pTsk. The condition type EXT_FORCED, the file name fileName and the 
line number in the file lineNo are passed to the function. The signal error can 
be retrieved by the exception handler. 

TskRaiseException can be used to signal special conditions to an exception 
handler. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
error - The signal value. 

Return Value 

No return value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition, TskLogCond, TskPreCond, TskPtrCond, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskOnException, 
TskPropagateExceptionHandler 
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TskPtrCond 



See Also 

TskCondltion, TskLogCond, TskPreCond, TskRaiseExceptlon, 
TskMalnLogCond, TskMalnPreCond, TskMainPtrCond, 
TskMainRaiseException, TskOnException, TskPropagateExceptionHandler 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskPtrCond function. 
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TskPtrCond 



Summary 

#lnclude "cobjects.h 1 
#lnclude "tskmac.h" 



Void 
PTSK 

Mediumlnt 



TskPtrCond( pTsk, error ) 

pTsk: 
error; 



Public Function 

This function is only available as a macro 



Purpose 



The TskPtrCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type 
EXTVALID.PTR, the file name fileName and the line number in the file lineNo 
are passed to the function. 

The TskPtrCond is used throughout C+O to check for illegal pointer values 
before attempting to execute the function. The production libraries turn off 
most precondition checking. 

TskPtrCond is most frequently used as part of the class pointer asserts found 
in the header files for each class. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program teraiination and a cryptic error message. 
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TskPropagateException 



Example 



Example of using a multiple level exception handler: 

Void TskProcess( pTsk ) 
PTSK pTsk; 

{ 

TskAssert( pTsk); 



r Set up a second exception handler for special errors 7 

if ( TskOnException( pTsk ) ) { 
I* If an exception occurs, program control will jump to 7 
r this IF statement. The code within this IF statement 7 
r will be used to report the exception 7 



r If control should be passed to higher level handler 7 
^ return TskPropagateException( pTsk ); 
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TskPropagateException 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskPropagateException( pTsk, useFilter ) 

PTSK pTsk; 
Bool useFilter; 

Public Function 

Purpose 

The TskPropagateException function will pass the last exception detected to the 
next exception handler for the Task pTsk. The useFilter flag determines 
whether the exception filter routine will be called. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
useFilter - If True the exception filter routine defined in the 
Tsklnit call will be called. 

Return Value 

No return value 
Notes 

[The exception stack must not be empty for the Task pTsk.) 
[There must be no recursion of the exception.) 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskEaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskCondition, 
TskOnException 
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TskPrintException 



Example 

Example of printing exception handler message: 

int main( argc, argv ) 
int argc; 
char *argv[l; 

{ 

r Initialize the Task using the default task TskMain 7 
TskDefaultlnit( TskMain, argc, argv ); 

r Set up an exception handler using the TskOnException call */ 
if ( TskOnException( TskMain ) ) { 



/* Print a message identifying the exception 7 
TskPrintException( TskMain ); 

/* Exit the task with an error code 7 
return TskExit( TskMain, 1 ); 



} ' 
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TskPrintException 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskPrintException( pTsk ) 

PTSK pTsk; 

Public Function 

Purpose 

The TskPrintException function prints the description of the exception. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

No return value 
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TskPreCond 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskPreCond function. 
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TskPreCond 



Summary 

#lnclude "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 

Mediumlnt 



TskPreCond( pTsk, error ) 

pTsk; 

error; 



Public Function 

This function Is only available as a macro 



Purpose 



The TskPreCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type 
EXT_PRECONDITION, the file name fileName and the line number in the file 
lineNo are passed to the function. 

The TskPreCond is used throughout C+O to check for illegal parameter values 
and other preconditions that must hold before attempting to execute the 
function. Hie production libraries turn off most precondition checking. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 



An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 



TskCondition, TskLogCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskOnException, 
TskPropagateExceptionHandler 



Notes 



See Also 
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TskPopExceptionHandler 



Example 



Void TskProcess( pTsk ) 
PTSK pTsk; 

{ 

TskAssert( pTsk ); 



r Set up a second exception handler for special errors */ 
if ( TskOn Exception ( pTsk ) ) { 



TskPrintException( TskMain ); 
} " 



I* If no exception was detected pop the stack prior to returning */ 
TskPopExceptionHandler( pTsk ); 
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TskPopExceptionHandler 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 



TskPopExceptionHandler( pTsk ) 

pTsk; 



Public Function 



Purpose 



The TskPopExceptionHandler function pops to the exception handler stacked 
below this one for the Task pTsk. 



Return Value 

No return value 
Notes 

[The exception stack must not be empty for the Task pTsk.] 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskOnException, 
TskPropagateExceptionHandler 



Parameter - Description 



pTsk 



Pointer to a structure of type Task. 
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TskOn Exception 



Example 

Example of setting up a single level exception handler: 

int main( argc, argv ) 
int argc; 
char *argvQ; 

{ 

r Initialize the Task using the default task TskMain 7 
TskDefaultlnit( TskMain, argc, argv ); 

I* Set up an exception handler using the TskOn Exception call */ 

if ( TskOn Exception( TskMain ) ) { 
I* If an exception occurs, program control will jump to 7 
r this IF statement. The code within this IF statement 7 
/* will be used to report the exception 7 



i* Exit the task with an error code 7 
return TskExit( TskMain, 1 ); 



r Call the program code 7 
TskProcess( TskMain ); 

TskNormalExit( TskMain ); 
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TskOnException 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 




Public Function 

This function Is only avaUable as a macro 



Purpose 



The TskOnException function sets up an exception handler for catching 
exceptions raised during program execution of Task pTsk. The semantics for 
TskOnException is much like the ANSI C functions setjmp/longjmp. The return 
value is 0 when the exception handler is first set-up and non-zero if an 
exception is caught. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

Return Value 

No return value 



The call to TskOnException should always be within an if statement with no 
other expressions. The body of the if statement is the exception handler. 

Before returning from the function which sets up an exception handler, that 
function must call TskPopExceptionHandler. The results are undefined if the 
user fails to do this. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskCondition, TskPropagateException 



Notes 
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TskNormalExit 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Void 

PTSK 



TskNonnalExit( pTsk ) 

pTsk; 



Public Function 



Purpose 



The TskNormalExit function is equivalent to the C function exitO. The function 
deinitializes the Task pTsk and exits the task with the exit value zero. This 
function is equivalent to a class deinit function. 



Return Value 

No return value 

Notes 

The TskNormalExit function will be the last function called before returning to 
the operating system. 

See Also 

TskExit, TskExitWithMsg 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskNormalExit function. 



Parameter - Description 



pTsk 



Pointer to a structure of type Task. 
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TskMainRaiseException 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskMainRaiseException function. 
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TskMainRaiseException 



Summary 

#include "cobjccts.h" 
#include "tskmac.h" 

Void TskMainRaiseException( error ) 

Mediumlnt error; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskMainRaiseException function raises an exception unconditionally for 
the Task TskMain. The condition type EXT_FORCED, the file name fileName 
and the line number in the file lineNo are passed to the function. The signal 
error can be retrieved by the exception handler. 

TskMainRaiseException can be used to signal special conditions to an 
exception handler. 

Parameter - Description 



error - The signal value. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskPopExceptionHandler, TskCondition, 
TskOnException, TskPropagateException 
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TskMainPtrCond 



Example 

Example of using the TskMainPtrCond function as used by the 
GrfAssert function in C+O. 

#define GrfAssert(pGrf) \ 

TskMainRrCond(pGrf->check==GRF_CHECK_WORD) 
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TskMainPtrCond 



Summary 

#Include "cobjects.h" 
#lnclude "tskmac.h" 

Void TskMainPtrCond( error ) 

Mediumlnt error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskMainPtrCond function checks the condition flag error and raises an 
exception if error is zero for the Task TskMain. The condition type 
EXT_VALID_PTR, the file name fileName and the line number in the file lineNo 
are passed to the function. 

The TskMainPtrCond is used throughout C+O to check for illegal pointer values 
before attempting to execute the function. The production libraries turn off 
most precondition checking. 

TskMainPtrCond is most frequently used as part of the class pointer asserts 
found in the header files for each class. 

Parameter - Description 



error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskCondition, TskMainPreCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskPropagateException 
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TskMainPreCond 



Example 

Example of using the TskMainPreCond function as used by the 
LeITest function in C+O. 

Void LelTest( pLel ) 
PLEL pLel; 

TskMainPreCond( pLel != NULL ); /* pLel cannot be NULL 7 
LelAssert( pLel ); 

r The successor list element must point to pLel */ 
if ( pLel->next ) 
TskMainPreCond( pLel->next->prev == pLel ); 

r The predecessor list element must point to pLel */ 
if ( pLel->prev ) 
TskMainPreCond( pLel->prev->next == pLel ); 
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TskMainPreCond 



Summary 

#mclude "cobjects.h" 
#include "tskmac.h" 

Void TskMainPreCond( error ) 

Mediumlnt error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskMainPreCond function checks the condition flag error and raises an 
exception if error is zero for the Task TskMain. The condition type 
EXT_PRECONDmON, the file name fileName and the line number in the file 
lineNo are passed to the function. 

The TskMainPreCond is used throughout C+O to check for illegal parameter 
values and other preconditions that must hold before attempting to execute the 
function. The production libraries turn off most precondition checking. 

Parameter - Description 



error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskCondition, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskPropagateException 
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TskMainLogCond 



Example 

Example of using the TskMainLogCond function as used by the 
GrfClear function in C+O. 

Void GrfClear( pGrf ) 
PGRF pGrf; 

{ Blk blk; 

GrfAssert( pGrf ); 

Blklnit( &blk, (Method) VtxClear); 
GrfVisitVtxClient( pGrf, 0, &blk ); 
BlkDeinit( &blk ); 

I* Failed to disconnect all vertices */ 

TskMainLogCond( DlllsEmpty( &pGrf->vtxList ) = True ); 

I* Failed to disconnect all edges 7 

TskMainl_ogCond( DlllsEmpty( &pGrf->edgList ) == True ); 

DpaClear( &pGrf->forwardSort ); 
DpaClear( &pGrf->backwardSort ); 

} 
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TskMainLogCond 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskMainLogCond( error ) 

Mediumlnt error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskLogCond function checks the condition flag error and raises an 
exception if error is zero for the Task TskMain. The condition type EXT_LOGIC, 
the file name fileName and the line number in the file lineNo are passed to the 
function. 

The TskMainLogCond is used throughout C+O to check for program logic 
errors or function specific conditions which should not arise. The production 
libraries turn off most logic checking. 

Parameter - Description 



error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition, TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskPropagateException 



Tsk- 19 



I 

TskLogCond 1 

Example !| 

Please refer to class test procedure m 
TST1 .C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the I 
TskLogCond function. m 

1 
1 
1 
1 

I 
1 
I 
1 
1 
1 
1 

1 
I 

1 
i 



TskLogCond 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskLogCond( pTsk, error ) 

PTSK pTsk; 
Mediumlnt error; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskLogCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type EXT_LOGIC, the 
file name fileName and the line number in the file lineNo are passed to the 
function. 

The TskLogCond is used throughout C+O to check for program logic errors or 
function specific conditions which should not arise. The production libraries 
turn off most logic checking. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskPropagateException 
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Tsklnit 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
Tsklnit function. 
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Tsklnit 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void Tsklnitf pTsk, argc, argv, maxNesting, excFuter ) 

PTSK pTsk; 

Mediumlnt argc; 

PSTR *argv; 

Mediumlnt maxNesting; 

ExcFllter excFilter; 

Public Function 

Purpose 

The Tsklnit function initializes the Task object. The Tsklnit function should be 
the first function called when using the Task class. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

argc - Argument count as passed by mainO. 

argv - Argument vector as passed by mainQ. 

maxNesting - Maximum number of levels for nesting of 

exception handlers. 
excFilter - Function to be called just prior to raising exception. If 

NULL no function is called. 

Return Value 

No return value 
Notes 

The last function to call when using the Task class is TskExit, 
TskExitWithMsg, or TskNormalExit. 

See Also 

TskDefaultlnit, TskExit, TskExitWithMsg, TskNormalExit 
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TskGetExceptionType 



Example 

Example of using an exception type: 

Void TskProcess( pTsk ) 
PTSK pTsk; 

Ext excType; 

TskAssert( pTsk ); 



/* Set up an exception handler for file I/O 7 

if ( TskOnException( TskMain ) ) { 
/* If an exception occurs, program control will jump to 7 
/* this IF statement. The code within this IF statement 7 
/* will be used to report the exception 7 



I* Find out the nature of the exception 7 
excType = TskGetExceptionType( TskMain ); 
if( excType == EXT_FORCED ) 
return TskExitWithMsg{ pTsk, "I/O Error - program aborted" ); 



} ' 



} ' 
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TskGetExceptionType 



Summary 

#include "cobjects.h 1 
#include "tskmac.h" 



Ext 
PTSK 




Public Function 



Purpose 

The TskGetExceptionType function returns the exception type. 

Parameter - Description 



pTsk 



Pointer to a structure of type Task. 



Return Value 

The return value from the TskGetExceptionCondition function is the exception 
type. 

See Also 

TskGetExceptionFileName, TskGetExceptionLineNo, TskGetExceptionCondition 



Tsk- 13 



TskGet Exception LineNo 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Mediumlnt TskGetExceptionLineNo( pTsk ) 
PTSK pTsk; 

Public Function 

Purpose 

The TskGetExceptionLineNo function returns the line number of the file where 
the exception was generated for the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

The return value from the TskGetExceptionLineNo function is the line number 
in a C source code file where the exception occured. 

See Also 

TskGetExceptionFileName, TskGetExceptionCondition, TskGetExceptionType 

Example 

Please refer to class test procedure 

TSTl.C,TST2.C,TST3.C t TST4.C t TST5.C,TST6.C for an example of the use of the 
TskGetExceptionLineNo function. 
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TskGet Exception FileName 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



PSTR 
PTSK 




Public Function 

Purpose 

The TskGetExceptionFileName function returns the filename where the 
exception was generated for the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 
Return Value 

The return value from the TskGetExceptionFileName function is the name of 
the C source code file where the exception occured. 

See Also 

TskGetExceptionUneNo, TskGetExceptionCondition, TskGetExceptionType 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetExceptionFileName function. 
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TskGetExceptionCondition 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Mediumlnt TskGetExceptionCondition( pTsk ) 
PTSK pTsk; 

Public Function 

Purpose 

The TskGetExceptionCondition function returns the exception condition error 
value. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

The return value from the TskGetExceptionCondition function is the exception 
condition error value. 

See Also 

TskGetExceptionFileName, TskGetExceptionLineNo, TskGetExceptionType 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetExceptionCondition function. 
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TskGetArgv 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



PSTR 

PTSK 



TskGetArgv( pTsk ) 

pTsk; 



Public Function 



Purpose 



The TskGetArgv function returns the argument vector as passed by mainO for 
the Task pTsk. 



Return Value 

The return value from the TskGetArgv function is a pointer to a String pointer. 

See Also 

TskGetArgc 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetArgv function. 



Parameter - Description 



pTsk 



Pointer to a structure of type Task. 
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TskGetArgc 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Mediumlnt TskGetArgc( pTsk ) 
PTSK pTsk; ~ 

Public Function 

Purpose 

The TskGetArgc function returns the argument count as supplied by mainO for 
the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 
Return Value 

See Also 

TskGetArgv 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetArgc function. 
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TskExitWithMsg 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskExitWithMsg(pTsk,msg) 
PTSK pTsk; 
PSTR msg; 

Public Function 

Purpose 

The TskExitWthMsg function is equivalent to the C function exitO with a 
printffmsg) statement immediately before it. The function deinitializes the Task 
pTsk and exits the task with an exit value of 1. This function is equivalent to a 
class deinit function. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
msg - Message string to print to the terminal using the C 

function prmtftmsg). 

Return Value 

No return value 

Notes 

The TskExitWithMsg function will be the last function called before returning 
to the operating system. 

See Also 

TskExit, TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C.TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskExitWithMsg function. 
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TskExit 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskExiK pTsk, exitVal ) 

PTSK pTsk; 
Mediumlnt exitVal; 

Public Function 

Purpose 

The TskExit function is equivalent to the C function exitO. The function 
deinitializes the Task pTsk and exits the task with the exit value exitVal. This 
function is equivalent to a class deinit function. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
exitVal - Exit value to pass to the C exitO function. 

Return Value 

No return value 

Notes 

The TskExit function will be the last function called before returning to the 
operating system. 

See Also 

TskExitWithMsg, TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskExit function. 
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TskDefaultlnit 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskDefaultlniK pTsk, argc, aigv ) 

PTSK pTsk; 
Mediumlnt argc; 
PSTR argv[]; 

Public Function 

Purpose 

The TskDefaultlnit function initializes the Task object. The TskDefaultlnit 
function should be the first function called when using the Task class. The 
user can also use the Tsklnit function which requires additional arguments. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
argc - Argument count as passed by mainO. 

argv - Argument vector as passed by mainO. 

Return Value 

No return value 

Notes 

The last function to call when using the Task class is TskExit, 
TskExitWithMsg, or TskNormalExit. 

See Also 

TskExit, TskExitWithMsg, Tsklnit, TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskDefaultlnit function. 
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TskDelnit 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 



TskDeInit( pTsk ) 

pTsk; 



Public Function 



Purpose 



The TskDelnit function deinitializes the Task object. The TskDelnit function 
should be the last function called when using the Task class. 



Return Value 

No return value 

Notes 

The first function to call when using the Task class is Tsklnit. 

See Also 

TskDefaultlnit, Tsklnit 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskDelnit function. 



Parameter - Description 



pTsk 



Pointer to a structure of type Task. 
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TskCondition 



Notes 

An exception handler must have been established prior to calling this function. 
[The exception stack must not be empty for the Task pTsk.] 
[There must be no recursion of the exception.] 
[The condition category must be valid.] 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskCondition function. 
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TskCondition 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskCondition( pTsk, type, error, f ileName, lineNo ) 

PTSK pTsk; 

Ext type; 

Mediumlnt error; 

PSTR fileName; 

Mediumlnt lineNo; 

Public Function 

Purpose 

The TskCondition function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The category of the condition type, 
the file name fileName and the line number in the file lineNo are passed to the 
function. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

type - Condition category of exception. This will be defined by 

the choice of Task exception macro, 
error - If error is equal to zero an exception is trigged. If type 

is EXT_FORCED any value of error will trigger 

exception. 

fileName - Name of file where exception occured. 
lineNo - Line number in file where exception occured. 

Condition categories: 

EXT_PRECONDITION Preconditions for execution, examples; function 

arguments, ranges, links. 
EXT_LOGIC Conditions during execution of code, examples; 

logic errors, out of bounds. 
EXT_VALID_PTR Used for checking the check word of objects. 

EXT_FORCED Forced exception, value of error overriden, 

examples; error during read/write. 

Return Value 

No return value 
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Class Reference for Task 



Structure Name: 
Abbreviation: 
Class Type: 



Task 
Tsk 

Primitive Class 



TreVisitSuccessors 



Diagram 



Walk the Tree for Successors 




O Element Not Visited 0 Element Visited and Order 

first Last 
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TreVisitSuccessors 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitSuccessors( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitSuccessors function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked in a forward direction for all 
successors and starts with the tree node that is the next sibling to pTre. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisit Leaves, TreVisitParents, TreVisitRange 
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TreVisitSuccPreOrder 



Diagram 

Walk the Tree for all successors in Pre- order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitSuccPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitSuccPreOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitSuccPreOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked starting with the pre-order successor 
to pTre and visits all successors of pTre. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The PreOrder 
successor to this node is first visited. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitBranchlnOrder, TreVisitPreOrder, TreVisitChildren, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitRange 



See Als 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TYeVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitSuccessors 

Diagram 



Walk the Tree for a Range of Siblings 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitRange 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Mediumlnt TreVisitRange( pTreBeg, pTreEnd, pBlk ) 
PTRE pTreBeg; 
PTRE pTreEnd; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitRange function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked for a range of sibling nodes, pTreBeg 
through pTreEnd. The siblings are visited in a forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node in a range. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node in a range. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

The return value from the TreVisitRange function is the number of times tree 
nodes are walkd. 

Notes 

The tree function may return a value but it is ignored. 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 
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TreVisitPreOrder 



Diagram 

Walk the Tree in Pre- order 




O Element Not Visited 0 Element Visited and Order 
First Last 
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TreVisitPreOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

Void TreVisitPreOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitPreOrder function walks the Tree and calls a Tree function for each 
tree node visited. The walk visits pTre first and calls TreVisitPreOrder 
recursively for each of its children. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitChildren, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitParents 



Diagram 

Walk the Tree Nearest Parents First 
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TreVisitParents 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitParents(pTre,pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitParents function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked by calling TreVisitParents recursively for 
the parent of pTre. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren. TreVisitChildrenBwd. TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitRange, TreVisitSuccessors 
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TreVisitLeaves 



Diagram 

Walk the Tree for Leaves 
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TreVisitLeaves 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitLeaves(pTre,pBlk) 
PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitLeaves function walks the Tree and calls the Tree function for each 
tree node visited. The function calls TreVisitLeaves recursively for each of its 
children. The nodes are visited if they are leaves (have no children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder. 
TreVisitDescInOrderBwd, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitlnOrderBwd 



Diagram 



Walk the Tree In-order backwards 
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TreVisitlnOrderBwd 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisitInOrderBwd( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitlnOrderBwd function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitlnOrderBwd 
recursively for the children of pTre, and then visiting pTre itself. The nodes are 
visited in a backward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRanee, 
TreVisitSuccessors 
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TreVisitlnOrder 



Diagram 

Walk the Tree In-order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitlnOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisitInOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitlnOrder function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked by calling TreVisitlnOrder recursively for 
the children of pTre, and then visiting pTre itself. The nodes are visited in a 
forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitDescPreOrder 



Diagram 

Walk the Tree Descendents in Pre- order 
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TreVisitDescPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitDescPreOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDescPreOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitPreOrder for each 
of its children. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescInOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitDesclnOrderBwd 



Diagram 

Walk the Tree Descendents In-order backwards 
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TreVisitDesclnOrderBwd 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TrcVisitDescInOrderBwd( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDesclnOrderBwd function walks the Tree and calls a Tree function 
for each tree node visited. The Tree is walked by calling TreVisitlnOrderBwd for 
the children of pTre. The nodes are visited in a backward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 
See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitDesclnOrder 



Diagram 



Walk the Tree Descendents In-order 
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TreVisitDesclnOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

Void TreVisitDescInOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDesclnOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitlnOrder for the 
children of pTre. The nodes are visited in a forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitDescBranchlnOrder 



Diagram 



Walk the Tree Descendent branches In-order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitDescBranchinOrder 



Summary 

#lncludc "cobjects.h" 
#lnclude "tremac.h" 

Void TreVisitDescBranchInOrder( pTre, pBlk ) 

FERE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDescBranchinOrder function walks the Tree and calls a Tree 
function for each tree node visited. The Tree is walked by calling 
TreVisitBranchlnOrder for each of Its children. The nodes are visited if they are 
branches (have children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 
See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren. TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescPreOrder, TreVisitDescInOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 



Tre - 105 



TreVisitChildrenBwd 



Diagram 

Walk the Tree for all Children Backwards 
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TreVisitChildrenBwd 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitChildrenBwd( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitChildrenBwd function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked for each of the children of the Tree 
pTre starting with its last child and ending with its first child. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitChildren 



Diagram 

Walk the Tree for all Children 
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TreVisitChildren 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitOuldren(pTre,pBlk) 
PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitChildren function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked for each of the children of the Tree pTre 
starting with its first child and ending with its last child. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitBranchlnOrder 



Diagram 

Walk the Tree branches In-order 




Tre - 100 



TreVisitBranchlnOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

Void TreVisitBranchInOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitBranchlnOrder function walks a Tree and calls a Tree function for 
each tree node visited. The tree is walked by calling TreVisitBranchlnOrder 
recursively for each of its children, and then visting pTre itself. The nodes are 
visited if they are branches (have children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitPreOrder, TreVisitChildren, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreSend Destroy 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreSendDestroy( pTre ) 

PTRE pTre; 

Public Function 

Purpose 

The TreSendDestroy function sends a message to the client of the Tree pTre 
asking it to destroy the tree node. The Tree client function will receive this 
message and should deinitialize or destroy the edge. This message function 
should be included in the Tree client message array. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreSendDestroy function. 
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TrePrevPreOrder 



Diagram 

Previous node of pTre in Pre- order 
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TrePrevPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TrePrevPreOrder( pTre ) 

PTRE pTre; 

Private Function 

Purpose 

The TrePrevPreOrder function returns the client of the pre-order predecessor 
the Tree pTre. The pre-order predecessor is the previous sibling of pTre. If pTre 
has no previous sibling the function TreClientPrevPreOrder is called recursively 
for the parent of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TrePrevPreOrder function is a pointer to the pre- 
order predecessor of the Tree pTre. NULL is returned if no node exists. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextUncle, 
TreNextPreOrder, TreParent, TrePrev 
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TrePrev 



Diagram 

Preceding Sibling of pTre 
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TrePrev 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TrePrev( pTre ) 

PTRE pTre; 

Private Function 

A macro is available for this function 

Purpose 

The TrePrev function returns the preceding sibling of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 
Return Value 

The return value from the TrePrev function is a pointer to the preceding sibling 
of the Tree pTre. NULL is returned if no previous sibling exists. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextUncle, 
TreNextPreOrder, TreParent, TrePrevPreOrder 
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TrePasteRangeLastChild 



See Also 

TreCutRange, TreCutChildren. TrePasteRangeFirstChild, 
TrePasteRangeAfterSibllng, TrePasteRangeBeforeSibling 

Diagram 



Paste Range of Children to the Tree 
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TrePasteRangeLastChild 



Summary 

#include "cobjects.h' 
#lnclude "tremac.h" 



Void 
PTRE 
PTRE 
PTRE 



TrePasteRangeLastChild( pTre, pTreBeg, pTreEnd ) 

pTre; 

pTreBeg; 

pTreEnd; 



Public Function 

A macro is available for this function 



Purpose 



The TrePasteRangeLastChild function links a range of the Tree nodes pTreBeg 
through pTreEnd to the Tree. The range is linked so that pTreEnd is the last 
child of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. Hie appended tree 
node(s) become the last child(ren) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a child of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a child of pTre. 

Return Value 

No return value 



pTreBeg must have a set of successors one of which is pTreEnd. 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

[pTreBeg must be the root node.) 



Notes 
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TrePasteRangeFirstChild 



See Also 

TreCutRange, TreCutChlldren, TrePasteRaiigeLastChild, 
TrePasteRangeAfterSibllng, TVePasteRangeBeforeSibling 

Diagram 



Paste Range of Children to the Tree 
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TrePasteRangeFirstChild 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 
PTRE 
PTRE 
PTRE 



TrePasteRangeFirstChild( pTre, pTreBeg, pTreEnd ) 

pTre; 

pTreBeg; 

pTreEnd; 



Public Function 

A macro Is available for this function 



Purpose 



The TrePasteRangeFirstChild function links a range of the Tree nodes pTreBeg 
through pTreEnd to the Tree pTre. The range is linked so that pTreBeg is the 
first child of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The inserted tree 
node(s) become the first childfren) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a child of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a child of pTre. 

Return Value 

No return value 



pTreBeg must have a set of successors one of which is pTreEnd. 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

[pTreBeg must be the root node.) 



Notes 
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TrePasteRangeBeforeSibling 



Notes (cont) 

(If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 
[pTreBeg must be the root node.] 

See Also 

TreCutRange, TreCutChildren, TrePasteRangeLastChild, 
TrePasteRangeFirstChild, TrePasteRangeAfterSibling 

Diagram 

Paste Range of Siblings to the Tree 
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TrePasteRangeBeforeSibling 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TrePasteRange6eforeSibling( pTre, pTreBeg, pTreEnd ) 

PTRE pTre; 

PTRE pTreBeg; 

PTRE pTreEnd; 



Public Function 

A macro Is available for this function 

Purpose 

The TrePasteRangeBeforeSibling function links the range of Tree nodes 
pTreBeg through pTreEnd as children of the parent of the Tree pTre. The range 
is linked so that the nodes are the predecessor siblings of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The inserted tree 
node(s) become previous sibling(s) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a previous sibling of 
pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a previous sibling of 
pTre. 

Return Value 

No return value 

Notes 

pTreBeg must have a set of successors one of which is pTreEnd. 
[pTre must be a parent.] 
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TrePasteRangeAfterSibling 

Notes (cont) 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 
IpTreBeg must be the root node.] 

See Also 

TreCutRange, TreCutChildren, TrePasteRangeFirstChild, 
TrePasteRangeLastChlld, TrePasteRangeBeforeSibllng 



Diagram 



Paste Range of Siblings to the Tree 
pTre —v T Before 
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TrePasteRangeAfterSibling 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TrePasteRangeAf terSibling( pTre, pTreBeg, pTreEnd ) 

PTRE pTre; 
PTRE pTreBeg; 
PTRE pTreEnd; 

Public Function 

A macro Is available for this function 

Purpose 

The TrePasteRangeAfterSibling function links the range of Tree nodes pTreBeg 
through pTreEnd as children of the parent of the Tree pTre. The range is linked 
so that the nodes are the successor siblings of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The appended tree 
node(s) become next sibling(s) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a sibling of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a sibling of pTre. 

Return Value 

No return value 

Notes 

pTreBeg must have a set of successors one of which is pTreEnd. 
[pTre must be a parent.] 
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TreParent 



Diagram 

Parent of pTre 
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TreParent 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreParent( pTre ) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreParent function returns the parent of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreParent function is a pointer to the parent of the 
Tree pTre. NULL is returned if no parent node exists. 

See Also 

TreFlrstChild, TreLastChild, TreLastLeaf, TreNext, TreNextUncle, 
TreNextPreOrder, TrePrev, TrePrevPreOrder 
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TreNextUncle 



Diagram 

Successor Uncle of pTre 
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TreNextUncle 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreNextUncle( pTre ) 

PTRE pTre; 

Private Function 

Purpose 

The TreNextUncle function returns the successor uncle of the Tree pTre. The 
next uncle is found by taking the successor of the parent of pTre. If the parent 
has no successor the function TreNextUncle is called recursively until the root 
node is reached or an uncle is found. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreNextUncle function is a pointer to the next uncle 
of the Tree pTre. NULL is returned if there is no uncle. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextPreOrder, TreParent, 
TrePrev, TrePrevPreOrder 
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TreNextPreOrder 



Diagram 

Next node of pTre in Pre- order 
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TreNextPreOrder 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



PTRE 
PTRE 



TreNextPreOrder( pTrc ) 
pTre; 



Private Function 



Purpose 



The TreNextPreOrder function returns the pre-order successor of the Tree pTre. 
The pre-order successor is: i) the first child of pTre; ii) the successor sibling of 
pTre; ii) the uncle of pTre. 

Parameter - Description 



Return Value 

The return value from the TreNextPreOrder function is a pointer to the pre- 
order successor of the Tree pTre. NULL is returned if there is no successor. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextUncle, TreParent, 
TrePrev, TrePrevPreOrder 



pTre 



Pointer to a structure of type Tree. 
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TreNext 



Diagram 

Successor Sibling of pTre 
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TreNext 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreNexK pTre ) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreNext function returns the successor sibling of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreNext function is a pointer to the successor sibling 
node of the Tree pTre. NULL is returned if there is no sibling. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNextUncle, TreNextPreOrder, 
TreParent, TrePrev, TrePrevPreOrder 
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TreLastLeaf 



Diagram 



Last Leaf of pTre 




Last Leaf 



first 



Last 
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TreLastLeaf 



Summary 

#include "cobjects.h' 
#lnclude "tremac.h" 



PTRE 

PTRE 



TreLastLeaf ( pTre ) 

pTre; 



Private Function 



Purpose 



The TreLastLeaf function returns the last leaf of the Tree pTre. The last leaf is 
found by calling TreLastLeaf recursively for the last child of pTre until a node is 
visited that has no children. 

Parameter - Description 



Return Value 

The return value from the TreLastLeaf function is a pointer to the last leaf of 
the Tree pTre. NULL is returned if there are no children. 

See Also 

TreFirstChild, TreLastChild, TreNext, TreNextUncle, TreNextPreOrder, 
TreParent, TrePrev, TrePrevPreOrder 



pTre 



Pointer to a structure of type Tree. 
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TreLastChild 



Diagram 



Last Child of pTre 
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TreLastChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreLastChild(pTre) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreFirstChild function returns the last child of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreLastChild function is a pointer to the last child of 
the Tree pTre. NULL is returned if there are no children. 

See Also 

TreFirstChild, TreLastLeaf, TreNext, TreNextUncle, TreNextPreOrder, 
TreParent, TrePrev, TrePrevPreOrder 
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TrelsRoot 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Bool TrelsRooH pTre ) 

PTRE pTre; 

Public Function 

A macro is available for this function 

Purpose 

The TrelsRoot function determines if the Tree pTre has no parent. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 
Return Value 

The return value from the TrelsRoot function is True if the Tree pTre has no 
parent node, otherwise False is returned. 

See Also 

TreHasChildren, TreHasSiblings, TrelsChild, TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TrelsRoot function. 
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TrelsDirectAncestor 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Bool TreIsDirectAncestor( pTre, pTreA ) 

PTRE pTre; 
PTRE pTreA: 

Public Function 

Purpose 

The TrelsDirectAncester function determines if the Tree pTre is a parent, grand 
parent, or any other direct ancestor of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
pTreA - Pointer to a structure of type Tree. This tree node 
should be direct ancestor of pTre. 

Return Value 

The return value from the TrelsDirectAncestor function is True if the Tree pTre 
is a parent, grand parent, or any other direct ancestor of pTre. 

See Also 

TreHasChildren, TreHasSiblings, TrelsChild, TrelsRoot 

Example 

Please refer to class test procedure TSTTRE^C for an example of the use of the 
TrelsDirectAncestor function. 
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TrelsChild 



Summary 

#lnclude "cobjects.h' 
#include "tremac.h" 



Bool 

PTRE 



TrelsChild(pTre) 

pTre; 



Public Function 

A macro Is available for this function 



Purpose 

The TrelsChild function determines if the Tree pTre has a parent node. 



Return Value 

The return value from the TrelsChild function is True if pTre has a parent, 
otherwise False is returned. 

See Also 

TreHasChildren, TreHasSiblings, TrelsRoot, TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TrelsChild function. 



Parameter - Description 



pTre 



Pointer to a structure of type Tree. 
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Trelnit 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 

PTRE 



TrelniK pTre ) 

pTre; 



Public Function 



Purpose 



The Trelnit function initializes the Tree object. The Trelnit function should be 
the first function called when using the Tree class. 

Parameter - Description 



Return Value 

No return value 

Notes 

The last function to call when using the Tree class is TreDelnit. 

See Also 

TreDelnit, TreDestroy 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
Trelnit function. 



pTre 



Pointer to a structure of type Tree. 
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TreHasSiblings 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Bool 

PTRE 



TreHasSiblings( pTre ) 
pTre; 



Public Function 

A macro Is available for this function 



Purpose ^ 

The TreHasSiblings function determines if the Tree pTre has any siblings. 

Parameter - Description 



Return Value 

The return value from the TreHasSiblings function is True if the Tree pTre has 
any siblings, otherwise False is returned. 

See Also 

TreHasChildren, TrelsChild, TrelsRoot TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreHasSiblings function. 



pTre 



Pointer to a structure of type Tree. 
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TreHasChildren 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Bool TreHasChildren( pTre ) 

PTRE pTre; 

Public Function 

A macro Is available for this function 

Purpose 

The TreHasChildren function determines if the Tree pTre has any children. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreHasChildren function is True if the Tree pTre has 
any children, otherwise False is returned. 

See Also 

TreHasSiblings, TrelsChild, TrelsRoot, TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreHasChildren function. 
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TreFirstChild 
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TreFirstChild 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

PTRE TreFirstChild( pTre ) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreFirstChild function returns the first child of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreFirstChild function is a pointer to the first child 
of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreLastChild, TreLastLeaf, TreNext, TreNextUncle, TreNextPreOrder, TreParent, 
TrePrev, TrePrevPreOrder 
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TreDestroyChildren 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 
PTRE 



TreDestroyChildren( pTre ) 

pTre; 



Public Function 



Purpose 



The TreDestroyChildren function sends a message to the clients of any children 
of the Tree pTre to destroy themselves. 

Parameter - Description 



Return Value 

No return value 

See Also 

TreClearChildren 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreDestroyChildren function. 



pTre 



Pointer to a structure of type Tree. 
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TreDestroy 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



it 



Void 
PTRE 



TreDestroy( pTre ) 
pTre; 



Public Function 

Purpose 

Hie TreDestroy function deallocates the memory used by the object and 
deinitializes the Tree object. The Tree pTre should not be referenced after this 
function call since its memory will have been deallocated. 

The Tree pTre and any children of pTre will be cleared prior to deinitializing 



Return Value 

No return value 

Notes 

[pTre must not have a sub-object.] 
See Also 

TreDelnit, TreDestroyChildren, Trelnit 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreDestroy function. 



pTre. 

Parameter - Description 



pTre 



Pointer to a structure of type Tree. 
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TreDelnit 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreDelniK pTre ) 

PTRE pTre; 

Public Function 

Purpose 

The TreDelnit function deinitializes the Tree object. The TreDelnit function 
should be the last function called when using the Tree class. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

No return value 
Notes 

The first function to call when using the Tree class is Trelnit. 
[pTre must be the root node.] 
[pTre must have no child nodes.] 
See Also 

TreDestroy, TreDestroyChildren, Trelnit 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreDelnit function. 
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TreCutRange 



Diagram 



Cut a Range from the Tree 
Before 




Siblings and Children 
remain linked 
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TreCutRange 



Summary 

#lnclude "cobjects.h 1 
#include "tremac.h" 



Void 

PTRE 

PTRE 



TreCutRange( pTreBeg, pTreEnd ) 

pTreBeg; 
pTreEnd; 



Public Function 

A macro Is available for this function 



Purpose 



The TreCutRange function unlinks a range of Tree nodes pTreBeg through 
pTreEnd from the Tree. The tree node preceding pTreBeg will be Bnked to the 
sucessor tree node of pTreEnd. The range pTreBeg through pTreEnd become 
roots but the sibling connections remain. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 

node to cut from the tree. 
pTreEnd - Pointer to a structure of type Tree. This is the last tree 

node to cut from the tree. 

Return Value 

No return value 



[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

See Also 

TreCutChildren, TrePasteRangeFirstChild, TrePasteRangeLastChild, 
TrePasteRangeAfterSibling, TrePasteRangeBeforeSibling 



Notes 
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TreCutChildren 



Diagram 

Cut all Children from the Tree 
Before 
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TreCutChildren 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreCutChildren( pTre ) 

PTRE pTre; 

Public Function 

A macro Is available for this function 

Purpose 

The TreCutChildren function unlinks any children of the Tree pTre from the 
Tree. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

No return value 
See Also 

TreCutRange, TrePasteRangeFirstChild, TrePasteRangeLastChild, 
TrePasteRangeAfterSibling, TrePasteRangeBeforeSibling 
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TreClientVisitSuccessors 



See Als 

TreCllentVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TVeClientVisitPreOrder, TVeClientVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TreClientVisitlnOrderBwd, 
TreCHentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TreClientVisitRange 

Diagram 



Walk the Tree for Successors 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreClientVisitSuccessors 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 



Void TreQientVisitSuccessorsC pTre, offset pBlk ) 

PTRE pTre; 

Mediumlnt offset; • 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitSuccessors function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked in a forward direction for 
all successors and starts with the tree node that is the next sibling to pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitSuccPreOrder 



See Als 

TreCUentVisitBranchlnOrder, TreClientVisitPreOrder, TreClientVisitChildren, 
TreCUentVtsitChildrenBwd, TreCUentVisitlnOrder, TreCUentVisitlnOrderBwd, 
TVeClientVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreCUentVisitDescInOrder.TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TreClientVisitRange, 
TreClientVisitSuccessors 

Diagram 



Walk the Tree, all successors in Pre- order 
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TreClientVisitSuccPreOrder 



Summary 

#Include "cobjects.h" 
#lnclude "tremac.h" 



Void TreaientVisitSuccPreOrder( pTre, offset, pBlk ) 

FERE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitSuccPreOrder function walks the Tree and calls the Tree 
client function for each tree node visited. The Tree is walked starting with the 
pre-order successor to pTre and visits all pre-order successors of pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The PreOrder 

successor to this node is the first visited, 
offset - The distance in bytes between the Tree pTre and it's 

client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitRange 



Notes 

The client function may return a value but it is ignored. 

(If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

See Also 

TreClientVisitSuccPreOrder, TreCllentVisitBranchlnOrder, 
TreClientVlsitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreCUentVisitlnOrder, TreClientVisitlnOrderBwd, 
TreClientVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreCllentVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TreClientVisitSuccessors 

Diagram 



Walk the Tree for a Range of Siblings 




First Last 
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TreClientVisitRange 



Summary 

#Include "cobjects.h" 
#Include "tremac.h" 



Mediumlnt TreQientVisitRanget pTreBeg, pTreEnd, offset, pBlk ) 

PTRE pTreBeg; 

PTRE pTreEnd; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitRange function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked for a range of sibling 
nodes, pTreBeg through pTreEnd. The siblings are visited in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node in a range. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node in a range. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientVisitRange function is the number of times 
tree nodes are visited. 
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TreClientVisitPreOrder 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreClientVisitChlldren, TreClientVisitChildrenBwd, TreCUentVisitlnOrder, 
TreCllentVisitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreClientVisitDescPreOrder, TreClientVisitDescInOrder, 
TreClientVisitDescInOrderBwd, TreCllentVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TreClientVisitSuccessors 

Diagram 



Walk the Tree in Pre- order 




O Element Not Visited © Element Visited and Order 

First Last 
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TreClientVisitPreOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreaientVisitPreOrder( pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitPreOrder function walks a Tree and calls the Tree client 
function for each tree node visited. The walk visits pTre first and calls 
TreClientVisitPreOrder recursively for each of its children. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitParents 



See Als 

TreCllentVisitSuccPreOrder, TreCUentVisitBranchlnOrder, 
TreCHentVisitPreOrder, TYeClientVisitChildren, TYeClientVisitChildrenBwd, 
TreCllentVisitlnOrder, TreClientVisitlnOrderBwd, 
TreCllentVisltDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreCllentVisitDescInOrder, TreClientVisitDescInOrderBwd, 
TreCllentVisitLeaves, TreClientVisitRange, TYeClientVisitSuccessors 

Diagram 



Walk the Tree Nearest Parents First 
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TreClientVisitParents 



Summary 

#include "cobjects.h" 
#Include "tremac.h" 



Void TreaientVisitParents( pTre, offset, pBlk ) 

PTRE pTre; 

Medlumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitParents function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitParents recursively for the parent of pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitLeaves 



See Also 

TVeClientVisitSuccPreOrder, TreClientVi&itBranchlnOrder, 
TreCllentVisitPreOrder. TYeClientVisitChildren, TYeClientVisitChildrenBwd, 
TVeCllentVisitlnOrder.TreCllentVisitlnOrderBwd, 
TreCllentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TVeClientVisitDescInOrder, TreCUentVisitDescInOrderBwd, 
TreClientVisitParents, TreClientVisitRange, TreCllentVisitSuccessors 

Diagram 



Walk the Tree for Leaves 
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TreClientVisitLeaves 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreQientVisitLeavesC pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitLeaves function walks the Tree and calls the Tree client 
function for each tree node visited. The function calls TreClientVisitLeaves 
recursively for each of its children. The nodes are visited if they are leaves 
(have no children). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitlnOrderBwd 



See Also 

TreCUentVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreCllentVisitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TreClientVisitDescBranchlnOrder, 
TreClientVisitDescPreOrder.TreClientVisitDescInOrder, 
TreCllentVisitDescInOrderBwd, TYeClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TVeClientVisitSuccessors 

Diagram 



Walk the Tree In-order backwards 
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TreClientVisitlnOrderBwd 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreQientVisitlnOrderBwdC pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt oflFset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitlnOrderBwd function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrderBwd recursively for the children of pTre, and then visiting 
pTre itself. The nodes are visited last to first. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitlnOrder 



See Also 

TreClientVisitSuccPreOrder, TreCIientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreClientVisitDescPreOrder, TreClientVisitDescInOrder, 
TreCllentVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreCllentVisitRange, TreClientVisitSuccessors 

Diagram 



Walk the Tree In-order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreClientVisitlnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreQientVisitlnOrderC pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitlnOrder function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrder recursively for the children of pTre, and then visiting 
pTre itself. The nodes are visited in a forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDescPreOrder 



See Als 

TreClientVisitSuccPreOrder, TreCllentVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChildren, TreClientVisitChlldrenBwd. 
TVeCllentVisitlnOrder, TreClientVisitlnOrderBwd, 
TreCUentVisitDescBranchlnOrder, TreCUentVisitDescInOrder, 
TreCUentVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreCUentVisitRange.TreClientVisitSuccessors 

Diagram 



Walk the Tree Descendents in Pre-order 




O Element Not Visited 0 Element Visited and Order 

first Last 
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TreClientVisitDescPreOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreClientVisitDescPreOrder pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitDescPreOrder function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitPreOrder for each of its children. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



Pointer to a structure of type Tree. The root of a tree 
walk. 

The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 
Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 



pTre 

offset 

pBlk 
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TreClientVisitDescLeaves 



See Als 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOi der, 
TreClientVisitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TreCUentVisitlnOrderBwd, 
TreCUentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreCUentVisitDescInOrder, TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TreClientVisitRange, 
TreClientVisitSuccessors 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreClientVisitDescLeaves function. 
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TreClientVisitDescLeaves 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreQientVisitDescLeavesC pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Private Function 

Purpose 

The TreClientVisitDescLeaves function walks the Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitLeaves for each of its children. The nodes are visited if they are 
leaves (have no children). The nodes are visited in a forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDesclnOrderBwd 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChUdren, TreClientVisitChildrenBwd. 
TreCllentVisitlnOrder, TreClientVisitlnOrderBwd, 
TreClientVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TreClientVisitSuccessors 

Diagram 

Walk the Tree Descendents In-order backwards 




O Element Not Visited © Element Visited and Order 

first Last 
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TreClientVisitDesclnOrderBwd 



Summary 

#Include "cobjects.h" 
#include "tremac.h" 

Void TredientVisitDescInOrderBwd( pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitDesclnOrderBwd function walks the Tree and calls a Tree 
client function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrderBwd for the children of pTre. The nodes are visited last to 
first. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDesclnOrder 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TYeClientVisitPreOrder, TreCllentVisitChildren, TreClientVisitChildrenBwd. 
TreClientVisitlnOrder, TreCllentVisitlnOrderBwd, 
TreCUentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TVeCIientVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TreCllentVisitSuccessors 

Diagram 



Walk the Tree Descendents In-order 




O Element Not Visited 0 Element Visited and Order 

first Last 
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TreClientVisitDesclnOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreClientVisitDescInOrdert pTre, offset, pBlk) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitDesclnOrder function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrder for the children of pTre. The nodes are visited in a 
forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDescBranchlnOrder 



See Also 

TreClientVisitSuccPreOrder, TreCUentVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TreClientVisitlnOrderBwd, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder,TreClientVisitDescInOrderBwd, 
TreCUentVisitLeaves, TreClientVisitParents, TreClientVisitRange, 
TreClientVisitSuccessors 

Diagram 



Walk the Tree descendent branches In-order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreClientVisitDescBranchlnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreaientVisitDescBranchInOrder( pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 1 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitDescBranchlnOrder function walks a Tree and calls the Tree 
client function for each tree node visited. The Tree is walked by calling 
TreClientVisitBranchlnOrder for each of its children. The nodes are visited if 
they are branches (have children). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitChildrenBwd 



See Also 

TVeClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TVeClientVisitPreOrder, TreClientVisitChildren, TreClientVisitlnOrder, 
TreClientVisitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreCllentVisitDescPreOrder, TreClientVisitDescInOrder, 
TreClientVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TVeClientVisitSuccessors 

Diagram 



Walk the Tree for all Children Backwards 

pTre 




O Element Not Visited 
first 



0 Element Visited and Order 

Last 
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TreClientVisitChildrenBwd 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitChildrenBwd( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitChildrenBwd function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked for each of the children 
of the Tree pTre starting with its last child and ending with its first child. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitChildren 



See Also 

Ti^ClientVisitSuccPreOrder, TYeClientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChildrenBwd, TreClientVisitlnOrder, 
TreClientVisitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreCllentVisitDescPreOrder, TreClientVisitDescInOrder, 
TreClientVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TYeCUentVisitSuccessors 

Diagram 



Walk the Tree for all Children 
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TreCHentVisitChildren 



Summary 

#include" "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitChadren( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreCHentVisitChildren function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked for each of the children 
of the Tree pTre starting with its first child and ending with its last child. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitBranchlnOrder 



See Ms 

TreClientVisitSuccPreOrder, TreClientVisitPreOrder, TreClientVisitChildren, 
TreClientVisitChildrenBwd, TreClientVisitlnOrder, TreClientVisitlnOrderBwd, 
TreClientVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TYeClientVisitDescInOrder, TreClientVisitDescInOrderBwd , 
TreClientVisitLeaves, TreClientVisitParents, TVeClientVisitRange, 
TreClientVisitSuccessors 

Diagram 
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TreClientVisitBranchlnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreaientVisitBrancMnOrder( pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitBranchlnOrder function walks a Tree and calls the Tree 
client function for each tree node visited. The tree is walked by calling 
TreClientVisitBranchlnOrder recursively for each of its children, and then 
visiting pTre itself. The nodes are visited if they are branches (have children). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientPrevPreOrder 



Diagram 

Previous node of pTre in Pre- order 
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TreClientPrevPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreQientPrevPreOrderC pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientPrevPreOrder function returns the client of the pre-order 
predecessor the Tree pTre. The pre-order predecessor is the previous sibling of 
pTre. If pTre has no previous sibling the function TreClientPrevPreOrder is 
called recursively for the parent of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientPrevPreOrder function is a pointer to the 
client of the pre-order predecessor of the Tree pTre. NULL is returned if pTre 
has no parent. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext, TreClientNextPreOrder, TreClientNextUncle, TreClientParent, 
TreClientPrev 
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TreClientPrev 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaientPrev( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientPrev function returns the client of the preceding sibling of the 
Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientPrev function is a pointer to the client of the 
previous sibling of the Tree pTre. NULL is returned if no previous sibling exists. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext, TreClientNextPreOrder, TreClientNextUncle, TreClientParent, 
TreClientPrevPreOrder 
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TreClientParent 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreQientParenK pTre, offset ) 

FERE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientParent function returns the client of the parent of the Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientParent function is a pointer to the client of 
the parent of the Tree pTre. NULL is returned if no node exists. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext, TreClientNextPreOrder, TreClientNextUncle, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientNextUncle 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreClientNextUncle( pTre, of fset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientNextUncle function returns the client of the successor uncle of 
the Tree pTre. The next uncle is found by taking the successor of the parent of 
pTre. If the parent has no successor the function TreClientNextUncle is called 
recursively until the root node is reached or an uncle is found. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNextUncle function is a pointer to the client 
of the next uncle of the Tree pTre. NULL is returned if there is no uncle node. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext, TreClientNextPreOrder, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientNextPreOrder 



Diagram 



Next node of pTre in Pre- order 




First Last 



Tre - 18 



TreClientNextPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreClientNextPreOrder( pTre, offset) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClientNextPreOrder function returns the client of the pre-order 
successor to the Tree pTre. The pre-order successor is: i) the first child of pTre; 
ii) the successor sibling of pTre; ill) the uncle of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNextPreOrder function is a pointer to the 
client of the PreOrder successor of the Tree pTre. NULL is returned if no 
PreOrder successor exists. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientNext 



Diagram 



Successor Sibling of pTre 

pTre — ^ ^V^-^ I Next Sibling 
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TreClientNext 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

POBJ TreClientNext(pTre, offset) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientNext function returns the client of the successor sibling of the 
Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNext function is a pointer to the client of 
the next sibling of the Tree pTre. NULL is returned if there is no sibling. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev. 
TreClientPrevPreOrder 



Tre- 15 



TreClientLastLeaf 



Diagram 

Last Leaf of pTre 




Tre - 14 



TreClientLastLeaf 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreClientLastLeaf( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientLastLeaf function returns the client of the last leaf of the Tree 
pTre. The last leaf is found by calling TreClientLastLeaf recursively for the last 
child of pTre until a tree node is visited that has no children. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientLastLeaf function is a pointer to the client 
of the last leaf of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChUd, TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientLastChild 

Diagram 



Last Child of pTre 
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TreClientLastChild 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

POBJ TreClientLastChild( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientLastChild function returns the client of the last child of the Tree 
pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientLastChild function is a pointer to the client 
of the last child of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreClient, TreClientLastChild, TreClientLastLeaf, TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 



Tre - 1 1 




1 
I 
I 
I 
i 
i 
i 

1 
i 

Tre - 10 

I 



TreClientFirstChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreClientFirstChild( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientFirstChild function returns the client of the first child of the Tree 
pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientFirstChild function is a pointer to the client 
of the first child of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreClient, TreClientLastChild, TreClientLastLeaf, TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientFindChild 



Diagram 



Find a Child by Visiting Children 

pTre 




o 

O Element Not Visited 



First 



© Element Visited and Order 

Last 
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TreClientFindChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



POBJ TreQientFmdChildC pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientFindChild function walks a Tree and calls the Tree client function 
for each tree node visited. The Tree is walked in a forward direction starting 
with the first child of pTre and ending with the last child of pTre. The function 
will terminate when the client function returns True or the last child is 
reached. If the client function returns True a pointer to the client of the tree 
node is returned otherwise NULL is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/False) value. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientFindChild function is a pointer to the client 
of the first child of the Tree pTre for which the client function returns True. 
Otherwise NULL is returned. 
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TreClient 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreQienK pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClient function returns a pointer to the client of the Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClient function is a pointer to the client of the 
Tree pTre. 

See Also 

TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreClient function. 
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TreClear 



Summary 

#Include "cobjects.h' 
#Include "tremac.h" 



it 



Void 
PTRE 



TreClear( pTre ) 
pTre; 



Public Function 



Purpose 



The TreClear function unlinks and destroys any children of the Tree pTre. If 
pTre is a child node then pTre is cut from the tree. 



Return Value 

No return value 

Notes 

[pTre must have no child nodes.] 
[pTre must be the root node.] 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreClear function. 



Parameter - Description 



pTre 



Pointer to a structure of type Tree. 
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TreAsObj 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreAsObj( pTre ) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreAsObj function returns a pointer to the Object structure contained by 
the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreAsObj function is a pointer to the Object 
structure contained by the Tree class. 

Notes 

The Object pointer can be used to send a message to the client of the Tree. 

See Also 

TreAsDll, TreAsLel 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreAsObj function. 
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TreAsLel 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PLEL TreAsLeK pTre ) 

PTRE pTre; 

Private Function 

A macro Is available for this function 

Purpose 

The TreAsLel function returns a pointer to the ListElement structure contained 
by the Tree pTre. The ListElement references the successor and predecessor 
sibling of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
Return Value 

The return value from the TreAsLel function is a pointer to the ListElement 
structure contained by the Tree pTre. The list element references the successor 
and predecessor sibling of pTre. 

See Also 

TreAsDll, TreAsObj 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreAsLel function. 
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TreAsDII 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

PDLL TreAsDIK pTre ) 

PTRE pTre; 

Private Function 

A macro is available for this function 

Purpose 

The return value from the TreAsDII function is a pointer to the List structure 
contained by the Tree pTre. The list contains the children of pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 
Return Value 

The return value from the TreAsDII function is a pointer to the structure of type 
List contained by the Tree class. The list contains the child nodes of pTre. 

See Also 

TreAsLel, TreAsObj 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreAsDII function. 
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Class Reference for Tree 



Structure Name: 
Abbreviation: 
Class Type: 



Tree 
Tre 

Inheritable class 



StrToUpper 



Example 

char bufferflO]; 

I* create a string */ 

strcpy( buffer, "abcdefghijk" ); 

/* convert the entire string to upper case */ 
StrToUpper( buffer ); 

printf( "buffer = %s\n", buffer ); 

Vhe following output will appear to the terminal: 
buffer = ABCDEFGHIJK 
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StrToUpper 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Void StrToUpper(pStr) 
PSTR pStr; 

Public Function 

A macro Is available for this function 

Purpose 

The StrToUpper function changes the case of the String pStr to all upper case. 

Parameter - Description 

pStr - String to be changed to upper case. 

Return Value 

No return value 
Notes 

The StrToUpper function uses the C library function toupperfj. 
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StrToMediumlnt 

Example 

{ 

int i; 

I* create an integer from the string 7 
i = StrToMediumlnt( "23" ); 

printf( "value = %d\n", i ); 

\he following output will appear to the terminal: 
value = 23 
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StrToMediumlnt 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Mediumlnt StrToMediumlnK pStr ) 

PSTR pStr; 

Public Function 

Purpose 

The StrToMediumlnt function returns the numerical representation of the 
String pStr. 

Parameter - Description 

pStr - String to be converted to a integer value. 

Return Value 

The return value from the StrToMediumlnt function is the numerical 
representation of the String pStr. 

Notes 

The StrToMediumlnt uses the C library function atoiO. 
See Also 

StrFromMediumlnt 
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StrToLower 



Example 

char buffer[10]; 

I* create a string 7 

strcpy( buffer, "ABCDEFGHIJK" ); 

I* convert the entire string to lower case 7 
StrToLower( buffer ); 

printf( "buffer = %s\n", buffer ); 

\he following output will appear to the terminal: 
buffer = abcdefghijk 
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StrToLower 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 

Void StrToLower( pStr ) 

PSTR pStr; 

Public Function 

A macro Is available for this function 

Purpose 

The StrToLower function changes the case of the String pStr to all lower case. 

Parameter - Description 

pStr - String to be changed to lower case. 
Return Value 

No return value 
Notes 

The StrToLower function uses the C library function tolowerO. 
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StrToDate 



Notes (cont) 

[The length of pStr must be less than 12.] 

See Also 

StrFromDate, JulDateStiToJulian, JuIValidateDate 

Example 



int year; 
int month; 
int day; 



I* create year, month, and day from a string 7 
StrToDate( "12-23-1988", DF_US, &year, &month, &day ); 

printf( "date %d/%d/%d\n", month, day, year ); 



The following output will appear to the terminal: 
date 12/23/1988 
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StrToDate 



Summary 

#include "cobjects.h" 
#include "strmac.h" 



Void StrToDate( pStr, format, year, month, day ) 

PSTR pStr; 

DateFormat fonnat; 

Mediumlnt *year; 

Mediumlnt *month; 

Mediumlnt *day; 



Public Function 

Purpose 

The SUToDate function converts the String pStr, containing a date, into the 
values of year, month, day. The format of the date string is controlled by 
passing a date format identifier. 

Parameter - Description 



pStr - Contains the date string of specified format. 

format - Date string format. 

year - Returns a 4 digit year. [1583 - 4712] 

month - Returns a 1-2 digit month. (1-12] 

day - Returns a 1-2 digit day. [1-31] 



date format: 

DF_US > MM-DD-YYYY 
DF.EUROPE > DD-MM-YYYY 
DF_MILITARY > YYYY-MM-DD 

Return Value 

No return value 

Notes 

This function is used to parse date strings and is used by the JidianTime class. 
The format can be controlled to any convention by editing the Class Source 
Code file jul.c and examining the sscanf statement within the function. 
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StrSqueeze 



Example 

charbufferfJO]; 

I* create a string 7 

strcpy( buffer, "ABCD12345" ); 

r remove a sub-string from a string V 
StrSqueeze( buffer, buffer, "123" ); 

printf( "buffer %s\n", buffer ); 

\he following output will appear to the terminal: 
buffer ABCD45 
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StrSqueeze 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 

Void StrSqueeze( pStrD, pStrS, ch ) 

PSTR pStrD; F 

PSTR pStrS; 
Char ch; 

Public Function 

Purpose 

The StrSqueeze function removes all occurences of the character ch from the 
String pStr. 

Parameter - Description 



pStrD - Returns the string with specified character removed. 
pStrS - String for character removal, 
ch - Single character to be removed. 

Return Value 

No return value 
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StrSet 



Example 

charstr[20]; 

r copy string to another string 7 
StrSet( str, "ABCD" ); 

printf( "str = %s\n", str); 

The following output will appear to the terminal: 
str = ABCD 
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StrSet 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Void StrSet( pStrD, pStrS ) 

PSTR pStrD; 
PSTR pStrS; 

Public Function 

A macro is available for this function 

Purpose 

The StrSet function copies the String pStrS to the the String pStrD. 

Parameter - Description 

pStrD - Returns the string with sub-string replaced. 
pStrS - Sub-string of original. 

Return Value 

No return value 
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StrReplaceSubStr 



Example 

char buffer[10]; 
I* create a string 7 

strcpy( buffer, "ABCD1 2345EFGHIJK" ); 

r replace a sub-string in a string V 
StrReplaceSubStr( buffer, "12345", "XX", 16 ); 

printf( "buffer %s\n", buffer ); 

The following output will appear to the terminal: 
buffer ABCDXXEFGH UK 
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StrReplaceSubStr 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 

Void StrReplaceSubStrC pStrOrg, pStrFrom, pStrTo, maxLen ) 

PSTR pStrOrg; v 

PSTR pStrFrom; 
PSTR pStrTo; 
Mediumlnt maxLen; 

Public Function 

Purpose 

The StrReplaceSubStr function replaces the sub-string pStrFrom of the 
pStrOrg with the sub-string pStrTo. 

Parameter - Description 



pStrOrg - Returns the string with sub-string replaced. 

pStrFrom - Sub-string of original. 

pStrTo - Sub-string to be used for replacement. 

maxLen - Maximum length of string. 

Return Value 

No return value 
Notes 

(maxLen must be in the range [0: 128].] 

See Also 

StrExtract 
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Strlnit 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Void Strlnit(pStr) 
PSTR pStr; 

Public Function 

A macro is available for this function 

Purpose 

The Strlnit function sets the String pStr contents to NULL. 

Parameter - Description 

pStr - A pointer to String. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTSTR.C for an example of the use of the 
Strlnit function. 
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StrFromMediumlnt 



Example 

char buffer[3]; 

r create a string from an integer */ 
StrFromMediumlnt( buffer, 2, 23 ); 

printf ( "buffer %s\n", buffer ) ; 

The following output will appear to the terminal: 
buffer 23 
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StrFromMediumlnt 



Summary 

#indude "cobjects.h" 
#include "strmac.h" 

Mediumlnt StrFromMediumInt( pStr, maxLen, num ) 
PSTR pStr; 
Mediumlnt maxLen; 
Mediumlnt num; 

Public Function 

Purpose 

The StrFromMediumlnt function returns the String pStr for the value num. 

Parameter - Description 



pStr - Returned string. The string should be able to hold the 
characters represented by the number plus a NULL 
terminator. 

maxLen - Maximum length of string. 

num - Value to be converted to a string. 

Return Value 

The return value from the StrFromMediumlnt function is the length of the 
string returned. The length of pStr is always less than or equal to maxLen. 

See Also 

StiToMediumlnt 
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Str From Date 



See Also 

StiToDate, JuUulianToDateStr 

Example 

char dateBuf[11]; 

I* create a string from the values of year, month, and day 7 
StrFromDate( dateBuf, DF_US, 1988, 12, 23 ); 

printf( "date %s\n", dateBuf ); 

\h& following output will appear to the terminal: 
date 12-23-1988 
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Str From Date 



Summary 

#include "cobjects.h" 
#include "strmac.h" 



Void StrFromDate( pStr, format, year, month, day ) 

PSTR pStr; 

DateFormat format; 

Mediumlnt year; 

Mediumlnt month; 

Mediumlnt day; 



Public Function 

Purpose 

The StrFromDate function returns the String pStr filled with the date 
represented by the values year, month, and day. The format of the date string 
is controlled by passing a date format identifier. 

Parameter - Description 



pStr - Returns the date string. The string should be able to 

hold 10 characters plus a NULL terminator, 
format - Date string format, 
year - A 4 digit year. [1583-4712] 
month - A 1-2 digit month. [1 - 12] 
day - A 1-2 digit day. [1 - 31] 



date format: 

DF_US > MM-DD-YYYY 
DF_EUROPE > DD-MM-YYYY 
DF_MILITARY > YYYY-MM-DD 

Return Value 

No return value 

Notes 

This function is used to create date strings and is used by the JidianTime class. 
The format can be controlled to any convention by editing the Class Source 
Code file str.c and examining the printf statement within the function. 
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StrExtract 



Example 



char buffer[32]; 



f extract a sub-string from a string */ 
/* starting at index 4 for 5 characters */ 
StrExtract( buffer, "ABCD1 2345EFGHIJK", 4, 5 ); 

printf( "buffer = %s\n M , buffer ); 

\he following output will appear to the terminal: 
buffer = 12345 
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StrExtract 



Summary 

#include "cobjects.h" 
#include "strmac.h" 



PSTR StrExtract( pStrD, pStrS, idx, n ) 

PSTR pStrD; 

PSTR pStrS; 

Mediumlnt idx; 

Mediumlnt n; 



Public Function 

Purpose 

The StrExtract function extracts the sub-string pStrD from the String pStrS 
starting at an index idx and for a number of characters n. 



Parameter - Description 



pStrD - Returns the extracted sub-string. 

pStrS - String to be extracted from. 

idx - Starting index for string extraction. [0 - length] 

n - Number of characters to be extracted. 



Return Value 

The return value from the StrExtract function is a pointer to the string 
extracted, or NULL. 

See Also 

StrReplaceSubStr 
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Class Reference for String 



Structure Name: String 
Abbreviation: Str 
Class Type: Primitive. 



Object 



This page is intentionally left blank 
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ObjSendMessageReturnPtr 



Summary 



#include "cobjects.h' 
#include "objmac.h" 



Void ObiSe 

POBJ pObj; 

Mediumlnt m; 

PBLK pBlk; 




eturnPtr( pObj, m, pBlk ) 



Public Function 

Purpose 

The ObjSendMessageReturnPtr function sends the message identified by its 
selector index m to the Object pObj. The Block pBlk can be used to pass 
parameters to the method implementing the message. The return value is the 
value returned by the method. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 

m - The message selector index. 

pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 



[The message number must be greater than or equal to zero, and less than the 
number of messages.l 

See Also 

ObjSendMessage, ObjSendMessageReturnlnt 



Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessageReturnPtr function. 



Notes 



Example 
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ObjSendMessageReturnlnt 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Mediumlnt ObjSendMessageReturnlnt pObj, m, pBlk ) 

Mediumlnt m; 
PBLK pBlk; 



Public Function 



Purpose 

The ObjSendMessageReturnlnt function sends the message identified by its 
selector index m to the Object pObj. The Block pBlk can be used to pass 
parameters to the method implementing the message. The return value is the 
value returned by the method. 

Parameter - Description 



pObj - Pointer to a structure of type Object 

m - The message selector index. 

pBlk - Pointer to a structure of type Block. 

Return Value 

The return value from the ObjSendMessageReturnlnt function is the value 
returned by the method whicn implements the message. 

Notes 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ObjSendMessage, ObjSendMessageReturnPtr 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessageReturnlnt function. 
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ObjSendMessage 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 

POBJ Ob|SendMessage(pObj,m,pBlk) 

Mediumlnt m; 
PBLK . pBlk; 

Public Function 

Purpose 

The ObjSendMessage function sends the message identified by its selector 
index m to the Object pObj. The Block pBlk can be used to pass parameters to 
the method implementing the message. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 

m - The message selector index. 

pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 

Notes 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ObjSendMessageReturnlnt, ObjSendMessageReturnPtr 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessage function. 
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ObjRespondsToSe lector 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Mediumlnt ObjRespondsToSelector( pObj, pStr ) 
POBJ pObj; 
PSTR pStr; 

Public Function 

Purpose 

The ObjRespondsToSelector function returns the index of the message selector 
if the Object pObj can respond to the selector String pointer pStr. If the Object 
pObj does not respond to the message, -1 is returned. 

Parameter - Description 

pObj - Pointer to a structure of type Object. 

pStr - Pointer to String which contains the selector name 

Return Value 

The return value from the ObjRespondsToSelector function is True if pObj 
responds to the selector and False otherwise. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjRespondsToSelector function. 
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ObjlsRoot 



Summary 

#include "cobjects.h 
#lnclude "objmac.h" 



Bool 

POBJ 



ObjlsRooK pObj ) 
pObj; 



Public Function 



Purpose 



The ObjlsRoot function returns True if the Object pObj is a root Object, that is, 
it does not have a subobject. 

Parameter - Description 



Return Value 

The return value from the ObjlsRoot function True if pObj is a root object or 
False otherwise. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjlsRoot function. 



pObj 



Pointer to a structure of type Object 
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Objlnit 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 

Void ObjlniK pObj, pQs ) 

POBJ pObj; 
PCLS pCls; 

Public Function 

Purpose 

The Objlnit function initializes the Object pObj to be an object of Class pCls. 

Parameter - Description 

pObj - Pointer to a structure of type Object. 
pCls - Pointer to a structure of type Class. 

Return Value 

No return value 

Notes 

If pObj was created with ClsCreateObject it does not need to be initialized since 
Objlnit is called automatically. 

If pObj was statically allocated, Objlnit should be the first function called. 
See Also 

ClsCreateObject, ObjDelnit, ObjDestroy 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
Objlnit function. 
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ObjGetSubObjectOffset 



Summary 

#include "cobjects.h" 
#include "objmac.h" 



Mediumlnt ObiGetSubObjectOffseK pObj ) 
POBJ pObj; 



Public Function 

Purpose 

The ObjGetlmmediateClientOffset function returns the offset of the immediate 
client. 

Parameter - Description 

pObj - Pointer to a structure of type Object. 
Return Value 

The return value from the ObjGetlmmediateClientOffset function is the offset of 
the immediate client object. 

See Also 

ObjGetlmmediateClient, ObjGetClient, ObjGetRootClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetSubObjectOffset function. 
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ObjGetSize 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Mediumlnt ObjGetSize( pObj ) 
POBJ pObj; 

Public Function 

Purpose 

The ObjGetSize function returns the size of the Object pObj. 
Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetSize function is the size of pObj. 

See Also 

ObjGetRootObjectSize 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetSize function. 
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ObjGetRootClientSize 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Mediumlnt ObjGetRootClientSize( pObi ) 
POBJ pObj; 

Public Function 

Purpose 

The ObjGetRootClientSize function returns the size of the root Object of the 
Object pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetRootClientSize function is the size of the root 
Object of pObj. 

See Also 

ObjGetSize 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetRootClientSize function. 
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ObjGetRootClient 



Summary 

#include "cobjecte.h" 
#include "objmac.h" 

POBJ ObjGetRootOient( pObj ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjGetRootClient function returns the Root client object of the Object 
pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object. 

Return Value 

The return value from the ObjGetRootClient function is a pointer to an Object 
Notes 

The root client is the client Object which has no subobjects. 

See Also 

ObjGetlmmediateClient, ObjGetClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetRootClient function. 
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ObjGetNthSuperObject 



Summary 

#includv3 "cobjects.h" 
#include "objmac.h" 

POBJ ObjGetNthSuperObje^pObjVn) 
Mediumlnt n; 
Public Function 

Purpose 

The ObjGetNthSuperObject function returns the Nth superobject of the Object 
pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object. 
n - The index of the superobject. 

Return Value 

The return value from the ObjGetNthSuperClient function is a pointer to an 
Object 

Notes 

(The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetNthSuperObject function. 
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ObjGetMethodAndOffset 



Example 

Please refer to class test procedure TSTOBJ:C for an example of the use of the 
ObjGetMethodAndOffset function. 
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ObjGetMethodAndOffset 



Summary 

#include "cobjects.h" 
#include "objmac.h" 



Void ObiGetMethodAndOffseK pObj, m, ppMth, pOffset ) 

POBJ pObj; 

Mediumlnt m; 

PMTH *ppMth; 

Mediumlnt *pOffset; 



Public Function 

Purpose 

The ObjGetMethodAndOffset function returns a pointer to the Method which 
implements the message identified by the message selector index m for the 
Object pObj. It also returns the offset which will determine the object to be 
passed to the method. The Method pointer is returned in ppMth and the offset 
in pOffset. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 

m - The message selector index. 

ppMth - Pointer to a pointer to Method. 

pOffset - Pointer to a Mediumlnt. 



range: *pOffset will be in the range (-2000:2000]. A negative value means a 
client of pObj is overriding the message. A positive value means pObj is 
inheriting the method from a superobject. A zero value is ambiguous and could 
be a client overriding the method or the method may be implemented by pObj. 

Return Value 

No return value 
Notes 

m must be in the range [0:N-1] where N is the number of objects pObj can 
respond to. 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 
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ObjGetlmmediateCIient 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

FOBJ ObiGetlmmediateQientC pObj ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjGetlmmediateCIient function returns the immediate client Object of the 
Object pObj. The immediate client is the object which directly subclasses pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetlmmediateCIient function is a pointer to an 
Object 

See Also 

ObjGetClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetlmmediateCIient function. 
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ObjGetClsName 



Summary 

#include "cobjects.h 1 
#include "objmac.h" 



PSTR 
POBJ 



ObjGetClsName( pObj ) 
pObj; 



Public Function 



Purpose 



The ObjGetClassName function returns a pointer to a String which contains the 
name of the Class which defines the Object pObj. 



Return Value 

The return value from the ObjGetClassName function is a pointer to a String 
containing the class name 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClsName function. 



Parameter - Description 



PObj 



Pointer to a structure of type Object. 
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ObjGetCIs 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

PCLS ObiGetas( pObj ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjGetCIs function returns a pointer to a structure of type Class which is 
the Class of the Object pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetCIs function is a pointer to a structure of type 
Class which is the Class of pObj. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetCIs function. 
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ObjGetClientOrNull 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClientOrNull function. 
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ObjGetClientOrNull 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

POBJ ObiGetQientOrNulK pObj, offset ) 

POBJ pObj; 
Mediumlnt offset; 

Public Function 

Purpose 

The ObjGetClientOrNull function returns the client Object of the Object pObj 
located at offset. If pObj is NULL, NULL is returned. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 
offset - The distance in bytes between the Object pObj and it's 
client pointer. 

Return Value 

The return value from the ObjGetClientOrNull function is a pointer to an 
Object. 

Notes 

The offset is calculated when the Class which defines pObj was created. See 
the section on Classes and MetaClasses for more details. 

The range for offset is [-2000:2000]. If the offset is zero or negative it means the 
object being retreived is a subobject (or client) of pObj. If the offset is positive, 
the object being retrieved is a superobject of pObj. 

See Also 

ObjGetClient 
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ObjGetClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClient function. 
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ObjGetClient 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 

POBJ ObjGetClient(pObj, offset) 

POBJ pObj; 
Mediumlnt offset; 

Public Function 

Purpose 

The ObjGetClient function returns the client Object of the Object pObj located 
at offset. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 
offset - The distance in bytes between the Object pObj and it's 
client pointer. 

Return Value 

The return value from the ObjGetClient function is a pointer to an Object 

Notes 

The offset is calculated when the Class which defines pObj was created. See 
the section on Classes and MetaClasses for more details. 

The range for offset is [-2000:2000]. If the offset is zero or negative it means the 
object being retreived is a subobject (or client) of pObj. If the offset is positive, 
the object being retrieved is a superobject of pObj. 

See Also 

ObjGetClientOrNull 
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Ob j Destroy 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Void ObjDestroy( pObj ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjDestroy function deinitializes and deallocates the Object pObj. The 
Object pObj should not be referenced after this call since the memory will have 
been freed. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

No return value 
Notes 

If the object was created from dynamic memory via ClsCreateObject, then the 
function ObjDestroy should be called instead of ObjDelnit. 

If the object was created from statically allocated memory, it should have been 
initialized via Objlnit in which case ObjDelnit should be used to deinitialize it. 

See Also 

ClsCreateObject, ObjDestroy, Objlnit 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjDestroy function. 
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ObjDelnit 



Summary 

#include "cobjects.h 1 
#include "objmac.h" 



Void 
POBJ 



ObjDelnit(pObj) 

pObj; 



Public Function 



Purpose 

The ObjDelnit function deinitializes the Object pObj. 
Parameter - Description 



pObj 



Pointer to a structure of type Object. 



Return Value 

No return value 

Notes 

If the object was created from dynamic memory via ClsCreateObject, then the 
function ObjDestroy should be called instead of ObjDelnit. 

If the object was created from statically allocated memory, it should have been 
initialized via Objlnit in which case ObjDelnit should be used to deinitialize it. 

The ObjDelnit function should be the last reference to pObj. 

See Also 

ClsCreateObject, ObjDestroy, Objlnit 



Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjDelnit function. 



Example 
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Class Reference for Object 



Structure Name: Object 

Abbreviation: Obj 

Class Type: Primitive Class. 



MsgSendReturnPtr 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgSendReturnPtr( pMsg, pObj, pBlk ) 

PMSG pMsg; 
POBJ pObj; 
PBLK pBlk; 

Public Function 

Purpose 

The MsgSendReturnPtr function sends the Message pMsg to the Object pObj 
and passes the Block pBlk parameters to the function which implements the 
message. The return value is the value returned by the function implementing 
the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pObj - Pointer to a structure of type Object 
pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 
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MsgSendReturnlnt 



Summary 

#Include "cobjects.h' 
#include "msgmac.h' 



it 



Mediumlnt 



MsgSendReturnInt( pMsg, pObj, pBlk ) 
pMsg: 



PMSG 

POBJ 

PBLK 




Public Function 



Purpose 



The MsgSendReturnlnt function sends the Message pMsg to the Object pObj 
and passes the Block pBlk parameters to the function which implements the 
message. The return value is the value returned by the function implementing 
the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pObj - Pointer to a structure of type Object. 
pBlk - Pointer to a structure of type Block. 

Return Value 

The return value from the MsgSendReturnlnt function is a the value returned 
by the method. 
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MsgSend 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgSend ( pMsg, pObj, pBlk ) 

PMSG pMsg; 
POBJ pObj; 
PBLK pBlk; 

Public Function 

Purpose 

The MsgSend function sends the Message pMsg to the Object pObj and passes 
the Block pBlk parameters to the function which implements the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pObj - Pointer to a structure of type Object 
pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 
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MsgPrint 



Summary 

#include "cobjects.h' 
#lnclude "msgmac.h' 



» 



Void 

PMSG 

PCIO 



pMsg; 
pCio; 
item; 
level: 
name; 



MsgPrint( pMsg, pCio, item, level, name ) 



Mediumlnt 
Mediumlnt 
PSTR 



Public Function 

Purpose 

The MsgPrint function prints the contents of the Message pMsg on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array element number of this instance (or -1). 

level - the level of indentation to print this object with, 

name - the name of this instance. 

Return Value 

No return value 
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Msglnit 



Summary 

#include "cobjects.h" 
#Include "msgmac.h" 



Void Msglnitt pMsg, pCls, pMms ) 

PMSG pMsg; 

PCLS pCls; 

PMMS pMms; 



Public Function 

Purpose 

The Msglnit function initializes the Message pMsg of the Class pCls with the 
MetaMessage pMms. 



Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pCls - Pointer to a structure of type Class. 
pMms - Pointer to a structure of type MetaMessage. 



Return Value 

No return value 



Msg -6 



MsgGetSelector 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

PSTR MsgGetSelector( pMsg ) 

PMSG pMsg; 

Public Function 

Purpose 

The MsgGetSelector function returns a pointer to a String containg the selector 
name. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 
Return Value 

The return value from the MsgGetSelector function is a pointer to a String 
containing the selector name. 
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MsgGetMethod 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

PMTH MsgGetMethod( pMsg ) 

PMSG pMsg; 

Public Function 

Purpose 

The MsgGetMethod function returns a pointer to a Method which implements 
the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 

Return Value 

The return value from the MsgGetMethod function is a pointer to a Method 
which implements pMsg. 
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MsgGetOffset 



Summary 

#include "cobjects.h" 
#lnclude "msgmac.h" 

Mediumlnt MsgGetOffseK pMsg ) 
PMSG pMsg; 

Public Function 

Purpose 

The MsgGetOffset function returns the Object offset for the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 

Return Value 

The return value from the MsgGetOffset function is the Object offset for this 
message. 
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MsgDelnit 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgDeInit( pMsg ) 

PMSG pMsg; 

Public Function 

Purpose 

The MsgDelnit function deinitializes the Message pMsg. The MsgDelnit 
function should be the last function called when using the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 

Return Value 

No return value 

See Also 

MsgDestroy, Msglnit 
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Class Reference for Message 

Structure Name: Message 

Abbreviation: Msg 

Class Type: Primitive Class 
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MscValidate 



Summary 

#include "cobjects.h' 
#include "mscmach" 



Void 
PMSC 



MscValidate( pMsc ) 
pMsc; 



Public Function 

Purpose 

The MscValidate function verifies that the MetaSuperClass pMsc is a valid 



Return Value 

No return value 
Notes 

Because instances of type MetaSuperClass are typically statically defined and 
initialized at compile time, this function provides a way of verifying that an 
instance was initialized properly. 

This function is called by MclValidate. 

An invalid instance will generate an exception. 

See Also 

MclValidate, MmsValidate 



instance. 



Parameter - Description 



pMsc 



Pointer to a structure of type MetaSuperClass. 
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MscPrint 



Summary 

#lnclude "cobjects.h' 
#include "mscmac.h' 



Void 

PMSC 

PCIO 



pMsc; 
pCio; 
item; 
level; 
name; 



MscPrint( pMsc, pCio, item, level, name ) 



Mediumlnt 
Mediumlnt 
PSTR 



Public Function 



Purpose 



The MscPrint function displays the contents of the MetaSuperClass pMsc on 
the ConsolelnputOutput device pCio. Item identifies if pMsc is part of an 
array, level indicates the level of identing to use when printing the contents, 
and name indicates the name of this instance. 

Parameter - Description 



pMsc - Pointer to a structure of type MetaSuperClass. 

pCio - Pointer to a structure of typ e ConsolelnputOutput. 

item - The array index of this instance or - 1 . 

level - The nesting level of this instance. 

name - Pointer to a String which names this instance. 

Return Value 

No return value 
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MscGetOffset 



Summary 

#include "cobjects.h" 
#include "mscmac.h" 

Mediumlnt MscGetOf fset( pMsc ) 
PMSC pMsc; 

Public Function 

Purpose 

The MscGetOffset function returns the offset of a superobject from an object for 
the MetaSuperClas pMsc. 

Parameter - Description 

pMsc - Pointer to a structure of type MetaSuperClass. 

Return Value 

The return value from the MscGetOffset function is the offset of the superobject 
from the object. 

Notes 

The offset is used by an object to retrieve its client(s), also called subobjects. 

A side effect of this function is to calculate the offset and store it in the offset 
pointed to by this instance. 

[The superobject offset must be in the range [0:2000].] 
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MscGetMetaClass 



Summary 

#lnclude "cobjects.h" 
#include "mscmac.h" 

PMCL MscGetMetadass( pMsc ) 

PMSC pMsc; 

Public Function 

Purpose 

The MscGetMetaClass function returns the pointer to a structure of type 
MetaClass for the MetaSuperClass pMsc. 

Parameter - Description 

pMsc - Pointer to a structure of type MetaSuperClass. 
Return Value 

The return value from the MscGetMetaClass function is a pointer to a structure 
of type MetaClass which is the MetaClass being inherited. 

See Also 

MscGetName 
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MscGetName 



Summary 

#include "cobjects.h' 
#include "mscmac.h' 



it 



PSTR 

PMSC 



MscGetName( pMsc ) 
pMsc; 



Public Function 



Purpose 



The MscGetName function returns a String pointer which uniquely identifies 
the MetaSuperClass pMsc. 



Return Value 

The return value from the MscGetName function is a String pointer to the name 
of the superclass 

Notes 

There must always be a superclass name. 

Superclasses are typically named the same as the structure they refer to. 
When a class inherits from two or more superclases of the same type, the 
superclass name is prefixed with a name describing its use. 

See Also 

MscGetMetaClass 



Parameter - Description 



pMsc 



Pointer to a structure of type MetaSuperClass. 
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Class Reference for MetaSuperClass 



Structure Name: 
Abbreviation: 
Class Type: 



MetaSuperClass 
Msc 

Primitive Class 



MmsValidate 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 

Void MmsValidate( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsValidate function determines whether or not the instance pMms is a 
valid, properly initialized MetaMessage. 

Parameter - Description 

pMms - Pointer to a structure of type MetaMessage. 
Return Value 
No return value 
Notes 

Because instances of MetaMessage are typically initialized at compile time, this 
function can be used to ensure that it was initialized properly. 

An invalid pMms will generate an exception. 
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MmsPrint 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 



Void MmsPrinK pMms, pCio, item, level, name ) 

PMMS pMms; 

PCIO pCio; 

Mediumlnt item; 

Mediumlnt level; 

PSTR name; 



Public Function 

Purpose 

The MmsPrint function displays the contents of the MetaMessage pMms on the 
ConsolelnputOutput device pCio. Item identifies if pMms is part of an array, 
level indicates the level of identing to use when printing the contents, and 
name indicates the name of this instance. 



Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array index of this instance or -1. 

level - The nesting level of this instance. 

name - Pointer to a String which names this instance. 



Return Value 

No return value 
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MmsGetSelector 



Summary 

#include "cobjects.h" 
#lnclude "mmsmach 1 



PSTR 
PMMS 



MmsGetSclector( pMms ) 
pMms; 



Public Function 

Purpose 

The MmsGetSelector function returns a String pointer which identifies the 
MetaMessage pMms. 



Return Value 

The return value from the MmsGetSelector function is the name of the selector 
for this message 



It is up to the user to make sure the selector name is initialized properly. 
There must always be a selector given. 

Selectors are typically named similarly to functions, but without the structure 
name prefix, and with the first letter lowercased. 

See Also 

MmsGetSuper, MmsGetSelector 



Parameter - Description 



pMms 



Pointer to a structure of type MetaMessage. 



Notes 
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MmsGetSuper 



Notes (cont) 

If the superclass is non-NULL and the method is non-NULL, this indicates the 
message is being overridden. It is verified during Class creation 
(MclCreateClassj that the superclass name is valid and that the named 
superclass does in fact respond to the selector in this message. 

Typically, the name of the superclass is specified as the full structure name to 
which it refers. 

See Also 

MmsGetSuper, MmsGetSelector 
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MmsGetSuper 



Summary 

#include •'cobjects.h" 
#include "mmsmach" 

PSTR MmsGetSuper( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsGetSuper function returns the String pointer which names the 
superclass the MetaMessage pMms inherits from. If this is a new message not 
inherited from any subclasses, the function returns NULL. 

Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

Return Value 

The return value from the MmsGetSuper function is the name of the 
superclass this message is inherited from or NULL if it is not inherited. 

Notes 

It is up to the user to initialize this value properly. Instances of this class are 
always asociated with a particular MetaClass instance. The name of the 
superclass must match precisely the name of one of the superclasses in the 
array of MetaSuperClasses contained in the MetaClass instance. 

If the method is NULL and so is the superclass name, this indicates that it is 
the responsibility of a subclass to implement this function. Failure to do so is 
detected at Class creation time (MclCreateClass). 

If the method is NULL, then this indicates the method is to be inherited from a 
superclass of the MetaClass which contains this MetaMessage. 

If the superclass name is NULL but the method is non-NULL, this indicates the 
message is unique to this class and not inherited from a superclass. It is up to 
the user to ensure this is true. Forthcoming versions of this code will verify 
this. 
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MmsGetMethod 



See Also 

MmsGetSuper, MmsGetSelector 
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MmsGetMethod 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 

PMTH MmsGetMethod( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsGetMethod function returns the Method (function) pointer for the 
MetaMessage pMms or NULL if the method is to be inherited from a 
superclass. 

Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

Return Value 

The return value from the MmsGetMethod function is a (function) pointer to 
the Method associated with the MetaMesage pMms or NULL. 

Notes 

If the method returned is NULL, then this indicates the method is to be 
inherited from a superclass of the MetaClass which contains this 
MetaMessage. 

If the method is NULL and so is the superclass name, this indicates that it is 
the responsibility of a subclass to implement this function. Failure to do so is 
detected at Class creation time (MclCreateClass). 

If the method is non-NULL but the superclass is NULL, this indicates the 
message is unique to this class and not inherited from a superclass. It is up to 
the user to ensure this is true. Forthcoming versions of this code will verify 
this. 

If the method is non-NULL and the superclass is non-NULL, this indicates the 
message is being overridden. It is verified during Class creation 
(MclCreateClass] that the superclass name is valid and that the named 
superclass does in fact respond to the selector in this message. 
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Class Reference for Met a Message 

Structure Name: MetaMessage 

Abbreviation: Mms 

Class Type: Primitive Class 
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MemSetChr 



Summary 

#include "cobjects.h" 
#lnclude "memmac.h" 



Void MemSetChx( pMem, s, i, n, os, c ) 

Mem *pMem; 

UMediumlnt s; 

UMediumlnt i; 

UMediumlnt n; 

UMediumlnt os; 

Chr c; 



Public Function 



Purpose 

The MemSetChr function sets a region of the array pMem to the Char c. The 
size of the array in elements is s, the beginning index is i, the number of 
elements to clear is n, and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements. 

i - First array index to start with. 

n - Number of elements to clear. 

os - Size of each element. 

c - The character to set the region to 



Return Value 

No return value 

Notes 

(i must be less s.] 

I(i + n) must be less or equal to s.] 

[os must be greater than 0.] 
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MemPasteNSet 



Summary 

#include "cobjects.h" 
#include "memmac.h' 



11 



Void 
Mem 



MemPasteNSetf pMem, s, i, n, os, c ) 
*pMem; 



UMediumlnt 
UMediumlnt 
UMediumlnt 
UMediumlnt 
Chr 



s; 

i; 
n; 
os; 
c; 



Public Function 



Purpose 



The MemPasteNSet function clears a region of the array pMem to zeros. The 
range of elements at from i through s are copied past the last element of the 
region being cleared. This results in the last n elements of the Memory pMem 
being copied over. The size of the array in elements is s, the beginning index is 
i, the number of elements to clear is n, and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to clear, 

os - Size of each element. 

Return Value 

No return value 

Notes 

[i must be less s.] 

[(i + n) must be less or equal to s.] 

[os must be greater than 0.] 
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Mem New 



Summary 

#include "cobjects.h" 
#include "memmac.h" 

PMEM MemNew( amount ) 

UMedinmlnt amount; 

Public Function 

Purpose 

The MemNew function returns newly allocated Memory of amount bytes. If the 
memory cannot be allocated, NULL is returned. 

Parameter - Description 

amoumt - The amount to allocate 
Return Value 

The return value from the function MemNew is a pointer to Memory which was 
allocated or NULL if it could not be allocated. 
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MemDuplicate 



Summary 

include "cobjects.h" 
#include "memmac.h" 



Void 
Mem 

UMediumlnt 
Mem 

UMediumlnt 



MemDuplicate( pMem, s, pMemS, os ) 

*pMem; 

s; 

*pMemS; 
os; 



Public Function 



Purpose 

The MemDuplicate function copies the Memory pMemS to the Memory pMem. 
The size of the Memory to copy in elements is s and the size of each element is 
os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements. 

pMemS - Pointer to Memory. 

os - Size of each element. 

Return Value 



No return value 



Notes 



[os must be greater than 0.] 
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Mem Destroy 



Summary 

#include "cobjects.h" 
#lnclude "memmac.h" 

Void MemDestroy( pMem ) 

PMEM pMem; 

Public Function 

Purpose 

The MemDestroy function deallocates the Memory pMem previously allocated 
by MemNew. 

Parameter - Description 

pMem - Pointer to Memory. 

Return Value 

No return value 



Mem -6 



MemCutNSet 



Summary 

#include "cobjects.h" 
#include "memmach' 



Void 
Mem 



MemCutNSeK pMem, s, i, n, os, c ) 
*pMem; 



UMediumlnt 
UMediumlnt 
UMediumlnt 
UMediumlnt 
Chr 



s; 

i; 

n; 

os; 

c; 



Public Function 



Purpose 



The MemCutNSet function deletes a region of the array pMem and copies 
elements following the region on top of the region being cut. The size of the 
array in elements is s, the beginning of the region to cut is i, the number of 
elements to cut is n, the size of each element is os, and c is the value to copy to 
the open positions at the end of the array. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to cut. 

os - Size of each element. 

Return Value 

No return value 

Notes 

[i must be less s.J 

[(i + n) must be less or equal to s.] 

[os must be greater than 0.] 
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I 



MemCopy 

Notes (cont) 

[(di + n) must be less or equal to s.J 
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MemCopy 



Summary 

#include "cobjects.h" 
#include "memmach" 

Void MemCopy( pMem, s, di, n, i, os ) 

Mem *pMem; 

UMediumlnt s; 

UMediumlnt di; 

UMediumlnt n; 

UMediumlnt i; 

UMediumlnt os; 



Public Function 



Purpose 

The MemCopy function copies, a region of the array pMem to another region. 
The destination index is di, the source index is i, the size of the array in 
elements is s, the number of elements to copy is n, and the size of each 
element is os. 



Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements. 

di - Destination index. 

n - Number of elements to copy. 

i - Source index. 

os - Size of each element. 



Return Value 

No return value 

Notes 

[i must be less s.] 
[(i + n) must be less or equal to s.] 
[os must be greater than 0.] 
(di must be less s.] 
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MemClear 



Summary 

#include "cobjects.h" 
#lnclude "memmac.h" 



Void MemClear( pMem, s, i, n, os ) 

Mem *pMem; 

UMediumlnt s; 

UMediumlnt i; 

UMediumlnt n; 

UMediumlnt os; 



Public Function 



Purpose 

The MemClear function clears a section of the array pMem to zeros. The size of 
the array in elements is s, the beginning index is i, the number of elements to 
clear is n, and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to clear, 

os - Size of each element. 



Return Value 

No return value 

Notes 

[i must be less s.] 

[(i + n) must be less or equal to s.] 

[os must be greater than 0.] 



Mem -2 



Class Reference for Memory 



Structure Name: Memory 

Abbreviation: Mem 

Class Type: Primitive Class 



MetaClass 
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MclValidate 



Summary 

#include "cobjects.h" 
#include "mcunac.h' 



Void 
PMCL 



MclValidate(pMcl) 
pMcl; 



Public Function 



Purpose 

The MclValidate function verifies that the MetaClass pMcl is a valid instance. 



Return Value 

No return value 

Notes 

Because instances of type MetaClass are typically statically defined and 
initialized at compile time, this function provides a way of verifying that an 
instance was initialized properly. 

Part of the validation of the instance is calling McIValidateMessages and 
MclValidateSuperClasses. 

An invalid instance will generate an exception. 

See Also 

McIValidateMessages, MclValidateSuperClasses 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclValidate function. 



Parameter - Description 



pMcl 



Pointer to a structure of type MetaClass. 
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MclSendDestroyClass 



Summary 

#include "cobjects.h' 
#include "mclmac.h' 



Void 

PMCL 

PCLS 



MdSendDestroyClass( pMcl, pQs ) 

pMcl; 

pCls; 



Public Function 



Purpose 



The MclSendDestroyClass function deallocates an instance of the Class pCls as 
specified by the MetaClass pMcl. 

Parameter - Description 



Return Value 

No return value 
See Also 

MclCreateClass. MclDestroyClass, MclSendCreateClass 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclSendDestroyClass function. 



pMcl 



Pointer to a structure of type MetaClass. 
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MclSendCreateClass 



Summary 

#lnclude "cobjects.h" 
#lnclude "mclmac.h" 



PCLS 
PMCL 



MdSendCreateClass( pMcl ) 
pMcl; 



Public Function 

Purpose 

The MclSendCreateClass function returns an instance of the Class described 
by the MetaClass pMcl. 



Return Value 

The return value from the MclSendCreateClass function is an instance of the 
Class described by the MetaClass pMcl. 

See Also 

MclCreateClass, MclDestroy, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclSendCreateClass function. 



Parameter - Description 



pMcl 



Pointer to a structure of type MetaClass. 
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MclPrint 



Summary 

#include "cobjects.h" 
#include "mcunac.h" 



Void 

PMCL 

PCIO 



pMcl; 
pCio; 
item; 
level; 
name; 



MclPrinK pMcl, pCio, item, level/ name ) 



Mediumlnt 
Mediumlnt 
PSTR 



Public Function 

Purpose 

The MclPrint function prints the contents of the MetaClass pMcl on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array element number of this instance (or -1). 

level - the level of indentation to print this object with, 

name - the name of this instance. 

Return Value 

No return value 



Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclPrint function. 



Example 



Mcl - 14 



MclGetSuperClassCount 

Summary 

#include "cobjects.h" 
#include "mclmac.h" 

Mediumint MdGetSuperClassCountC pMcl ) 
PMCL pMcl; 

Public Function 

Purpose 

The MclGetSuperClassCount function returns the number of superclasses to 
this MetaClass. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 

Return Value 

The return value from the MclGetSuperClassCount function is the number of 
superclasses in this MetaClass. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetSuperClassCount function. 
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MclGetNthSuper 



Summary 

#include "cobjects.h" 
#lnclude "mcunac.h" 

PMCL MdGetNthSuper( pMcl, n ) 

PMCL pMcl; 
Mediumlnt n; 

Public Function 

Purpose 

The MclGetNthSuper function returns the Nth superclass MetaClass of the 
MetaClass pMcl. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 
n - Index of the superclass being returned. 

Return Value 

The return value from the MclGetNthSuper function is the index in the list of 
MetaMessages understood by pMcl. If the selector is not found, -1 is returned. 

Notes 

(The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthSuper function. 
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MclGetNthOffset 



Summary 

#include "cobjects.h" 
#lnclude "mclmac.h" 

Mediumlnt MdGetNthOffset( pMcl, n ) 
PMCL pMcl; 
Mediumlnt n; 

Public Function 

Purpose 

The MclGetNthOffset function returns the offset of the Nth superclass of the 
MetaClass pMcl. The offset is used to calculate the distance between an object 
instance and its superclass. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched, 
n - Index of the superclass whose offset is being 

calculated. 

Return Value 

The return value from the MclGetNthOffset function is the offset of the Nth 
superclass from its subclass as specified by the MetaClass pMcl. 

Notes 

For the offset to be calculated correctly, the example instance of an object of 
this MetaClass type must be the same object instance referenced by the 
MetaSuperClass described by this MetaClass. 

[The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthOffset function. 
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MclGetNthMms 



Summary 

#lnclude "cobjects.h" 
#include "mclmac.h" 

PMMS MdGetNthMms( pMcl, n ) 

PMCL pMcl; 
Mediumlnt n; 

Public Function 

Purpose 

The MclGetNthMms function returns the Nth MetaMessage described by the 
MetaClass pMcl. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 
n - The index of the MetaMessage to return. 

Return Value 

The return value from the MclGetNthMms function is a pointer to a structure 
of type MetaMessage which is the Nth MetaMessage described by this 
MetaClass. 

Notes 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthMms function. 
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MclGetMessageCount 



Summary 

#include "cobjects.h" 
#lnclude "mclmac.h" 

Mediumint MclGetMessageCountf pMd ) 
PMCL pMcl; 

Public Function 

Purpose 

The MclGetMessageCount function returns the total number of MetaMessages 
which are included as part of the MetaClass instance pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 

Return Value 

The return value from the MclGetMessageCount function is the number of 
messages responded to by an instance of this type. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetMessageCount function. 
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MclGetClassSize 



Summary 

#lnclude "cobjects.h" 
#include "mclmac.h" 

UMediumlnt MclGetQassSize( pMcl ) 
PMCL pMcl; 

Public Function 

Purpose 

The MclGetClassSize function returns the size of an instance of the Class 
described by the MetaClass pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. The 
MetaClass being searched. 

Return Value 

The return value from the MclGetClassSize function returns the size of an 
instance of the MetaClass pMcl. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetClassSize function. 
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MclGetClassName 



Summary 

#lnclude "cobjects.h" 
#lnclude "mclmac.h" 



PSTR 

PMCL 



MdGetaassName( pMd ) 
pMcl; 



Public Function 



Purpose 



The MclGetClassName function returns the name of the class described by the 
MetaClass pMcl. 

Parameter - Description 



Return Value 

The return value from the MclGetClassName function is the name of the Class 
described by the MetaClass. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetClassName function. 



pMcl 



Pointer to a structure of type MetaClass. 
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MclFindSuperClass 



Summary 

#include "cobjects.h" 
#include "mclmac.h" 

Mediumlnt MdFindSuperClass( pMcl, pStr ) 
PMCL pMcl; 
PSTR pStr; 

Public Function 

Purpose 

The MclFindSuperClass function looks for the superclass pStr in the MetaClass 
pMcl and returns its index which can be used to locate its MetaClass. The 
function returns -1 if the superclass is not located. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched. 
pStr - Pointer to a String. The superclass name to search for. 

Return Value 

The return value from the MclFindSuperClass function is the index in the list 
of MetaSuperClass understood by pMcl. If the superclass is not found, -1 is 
returned. 

Notes 

The comparison between pStr and the superclass name is case sensitive. 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclFindSuperClass function. 
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MclFindSelector 



Summary 

#include "cobjects.h" 
#lnclude "mcbnac.h" 

Mediumlnt MclFindSelector( pMcl, pStr ) 
PMCL pMcl; 
PSTR pStr; 

Public Function 

Purpose 

The MclFindSelector function looks for the selector pStr in the MetaClass pMcl 
and returns its index which can be used to invoke the message. The function 
returns -1 if the selector is not located. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched. 
pStr - Pointer to a String. The selector name to search for. 

Return Value 

The return value from the MclFindSelector function is the index in the list of 
MetaMessages understood by pMcl. If the selector is not found, -1 is returned. 

Notes 

The comparison between pStr and the selector name is case sensitive. 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclFindSelector function. 
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Mc I Destroy Class il 

Example || 

Please refer to class test procedure TSTMCL.C for an example of the use of the >| 
MclDestroyClass function. 1 1 
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Mcl Destroy Class 



Summary 

#include "cobjects.h" 
#lnclude "mcunac.h" 

Void MclDestroyClass( pMcl, pCls ) 

PMCL pMcl; 
PCLS pCls; 

Friend Function 

Purpose 

The MclDestroyClass function deallocates the class instance pCls previously 
allocated by the MetaClass pMcl. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 
pCls - Pointer to a structure of type Class. The class instance 
to be deallocated. 

Return Value 

No return value 

Notes 

pCls must have been previously allocated by MclSendCreateClass using pMcl. 

Rather than using this function directly, the equivalent function 
SendDestroyClass should be called. This makes sure that if pCls is not the root 
class, that it is deinitialized properly before being deallocated. 

Class calls this function to deallocate the memory for the class after it has been 
deinitialized. 

See Also 

MclCreateClass, MclSendCreateClass, MclSendDestroyClass 



Mcl -3 



MclCreateClass 



Summary 

#include "cobjects.h' 
#include "mcunac.h" 



» 



» 



PCLS 
PMCL 



MclCreateClass( pMcl ) 
pMcl; 



Private Function 

Purpose 

The MclCreateClass function creates a new class instance based on the 
MetaClass pMcl. 



Return Value 

The return value from the MclCreateClass function is a pointer to a structure 
of type Class and is the new class instance. 



Rather than using CreateClass directly, a user should use the equivalent 
SendCreateClass function. This guarantees that if pMcl describes an extended 
Class that it is initialized properly. 

See Also 

MclDestroyClass, MclSendCreateClass, MclSendDestroyClass 



Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclCreateClass function. 



Parameter - Description 



pMcl 



Pointer to a structure of type MetaClass. 



Notes 



Example 
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Class Reference for MetaClass 



Structure Name: 
Abbreviation: 
Class Type: 



MetaClass 
Mcl 

Primitive Class 



ListElement 
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LeIVisitRange 



Diagram 

First Element — \ Last Element 

to Visit pLelBeg \ /to Visit pLelEnd 




First KXXXX - — ust 



Walk Elements 
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LeIVisitRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LelVisitRange( pLelBeg, pLelEnd, pBlk ) 

PLEL pLelBeg; 
PLEL pLelEnd; 
PBLK pBlk; 

Private Function 

Purpose 

The LeIVisitRange function walks the list for the range of ListElements pLelBeg 
through pLelEnd and calls a ListElement function for each list element visited. 

The Block pBlk contains the function and an optional list of arguments. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

beginning list element in a range. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

ending list element in a range. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

Return Value 

No return value 

Notes 

The ListElement function may return a value but it is ignored. 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeITest 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LelTest(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LeITest function validates the ListElement pLel. An invalid ListElement will 
generate an exception. 

Return Value 

No return value 

Notes 

(The successor list element must point to pLel.) 
[The predecessor list element must point to pLel.] 

Example 

Please refer to class test procedure TSTLEL. C.TSTDLL.C for an example of the 
use of the LeITest function. 
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LeISend Destroy 



Summary 

#include "cobjects.h' 
#lnclude "lelmac.h" 



Void 
PLEL 




Public Function 



Purpose 



The LelSendDestroy function sends a message to the client of the ListElement 
pLel asking it to destroy pLel. The ListElement client function will receive this 
message and should destroy the list element. This message function should be 
included in the ListElement client message array. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 

Return Value 

No return value 



Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LelSendDestroy function. 



Example 
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LeIPasteRangeBefore 



Notes (cont) 

(pLel cannot be identical to either pLelBeg or pLelEnd.J — 

See Also 

LelCut, LelCutRange, LelPasteRangeAfter 

Diagram 

Before After 
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LeIPasteRangeBefore 



Summary 

^include "cobjects.h" 
#include "lelmac.h" 



Void LelPasteRangeBef ore( pLel, pLelBeg, pLelEnd ) 

PLEL pLel; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

Purpose 

The LeIPasteRangeBefore function links a range of ListElemenis pLelBeg 
through pLelEnd to the List containing pLel, preceding the ListElemeni pLel. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 
elements will be linked preceding this list element. It 
cannot be NULL. 

pLelBeg - Pointer to a structure of type ListElement This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

pLelBeg and pLelEnd must belong to same list if any. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

[pLelBeg must not already be in a list.] 
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LeIPasteRangeAfter 



Notes (cont) 

[pLel cannot be identical to either pLelBeg or pLelEnd.) 

See Also 

LelCut, LelCutRange, LelPasteRangeBefore 

Diagram 

Before After 

Paste After 
this Element 
pLel 




JO <X> <X> Range of Elements 

pLelBeg ^-^-^pLelEnd 
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LeIPasteRangeAfter 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 



Void LelPasteRangeAfter( pLel, pLelBeg, pLelEnd ) 

PLEL pLel; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

Purpose 

The LeIPasteRangeAfter function links a range of ListElements pLelBeg through 
pLelEnd to the List containing pLel, succeeding the LtstElement pLel. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 
elements will be linked succeeding this list element. It 
cannot be NULL. 

pLelBeg - Pointer to a structure of type ListElement. This is the 
first list element to paste into in a list. 

pLelEnd - Pointer to a structure of type ListElement. This is the 
last list element to paste into in a list. 

Return Value 

No return value 

Notes 

pLelBeg and pLelEnd must belong to the same list if any. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

[pLelBeg must not already be in a list.] 
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Lellnit 



Summary 

#lnclude "cobjects.h" 
#lnclude "lelmac.h" 

Void Lellnit( pLel ) 

PLEL pLel; 

Public Function 

Purpose 

The LellnLtst function determines whether the LtstElement pLel is in a list. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the Lellnit function. 
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LeIGetPrev 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

PLEL LelGetPrev( pLel ) 

PLEL pLel; 

Friend Function 

A macro Is available for this function 

Purpose 

The LeIGetPrev function returns a pointer to the preceding list element to the 
ListElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeIGetPrev function is a pointer to the list element 
preceding the ListElement pLel. 

See Also 

LelGetNext, LelGetNthSuccessor 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetPrev function. 
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LeIGetNthSuccessor 



Summary 

#lnclude "cobjects.h" 
#lnclude "lelmac.h" 

PLEL LelGetNthSuccessor( pLel, offset ) 

PLEL pLel; 

Mediumlnt offset; 
Friend Function 

Purpose 

The LeIGetNthSuccessor function returns a pointer to the list element which is 
the Nth successor element forward in the list from the ListElement pLel. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 
offset - Offset from the ListElement pLel to another list 
element. [O-END] 

offset: END is the last consecutively numbered list element index. 

Return Value 

The return value from the LeIGetNthSuccessor function is a pointer to the Nth 
successor list element after the ListElement pLel. 

See Also 

LelGetNext, LeIGetNthSuccessor, LelGetPrev 
Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetNthSuccessor function. 
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LeIGetNext 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

PLEL LelGetNexK pLel ) 

PLEL pLel; 

Friend Function 

A macro is available for this function 

Purpose 

The LeIGetNext function returns a pointer to the succeeding list element to the 
ListElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeIGetNext function is the succeeding list element to 
the ListElement pLel. 

See Also 

LelGetNthSuccessor, LelGetPrev 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetNext function. 
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LeIGetDII 



Summary 

#include "cobjects.h 
#include "lelmac.h" 



PDLL 

PLEL 



LelGetDlK pLel ) 
pLel; 



Friend Fvmctlon 

A macro Is available for this function 



Purpose 



The LeIGetDII function returns a pointer to the List that the ListElement pLel is 
linked to. 

Parameter - Description 



Return Value 

The return value from the LeIGetDII function is a pointer to the List that the 
ListElement pLel is linked to. If the ListElement pLel does not belong to a list 
then NULL is returned. 



Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetDII function. 



pLel 



Pointer to a structure of type ListElement. 
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LeIGetClient 



Summary 

#lnclude "cobjects.h" 
#lnclude "lelmac.h" 

POBJ LelGetClienK pLel, offset ) 

PLEL pLel; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The LeIGetClient function returns the client pointer of the ListElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeIGetClient function is the client pointer of the 
ListElement pLel. 

See Also 

LelClientNext, LelClientPrev 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetClient function. 
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LeIDestroy 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LelDestroy( pLel ) 

PLEL pLel; 

Public Ftinctlon 

Purpose 

The LeIDestroy function deallocates the memory used by the object and 
deinltializes the ListElement object. The ListElement pLel should! not be 
referenced after this function call since its memory will have been deallocated. 

The list element is cut from the list prior to before destroying the object. 

Parameter - Description 

pLel - Pointer to a structure of type Graph. 
Return Value 
No return value 

Notes 

[The instance must be the outermost subclass; it cannot have a sub-object.] 

See Also 

LelDelnit, Lellnit 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIDestroy function. 
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LeIDelnit 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

Void LelDcInit(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LeIDelnit function deinitializes the ListElement object. The LeIDelnit 
function should be the last function called when using the ListElement class. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

No return value 
Notes 

The first function to call when using the ListElement class is Lellnit. 
pLel must be cut from the list prior to calling this function. 
[The list element must not be connected to any other elements.] 
[The list element must not be in a list.] 

See Also 

LelDestroy, Lellnit 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIDelnit function. 
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LeICutRange 

See Also 

LelCut, LelPasteRangeAfter, LelPasteRangeBefore 

Diagram 

Before After 

V A 



Range of Elements to Cut 
pLelBeg through pLelEnd 
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LeICutRange 



Summary 

#include "cobjects.h' 



#include "lelmac.h" 



Void 
PLEL 
PLEL 
{BLK 



LelCutRange( pLelBeg, pLelEnd ) 

pLelBeg; 
pLelEnd; 



Public Function 



Purpose 



The LeICutRange function unlinks the range of ListElements pLelBeg through 
pLelEnd from the list. The list element preceding pLelBeg will be linked to the 
successor list element of pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

beginning list element to cut. 
pLelEnd - Pointer to a structure of type ListElement This is the 

ending list element to cut. 

Return Value 

No return value 

Notes 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeICut 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

Void LelCut(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LeICut function unlinks the ListElement pLel from the list. The list element 
preceding pLel will be linked to the successor list element of pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

No return value 
Notes 

pLel must belong to a list. 

See Also 

LelCutRange, LelPasteRangeAfter, LelPasteRangeBefore 
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LeICountRange 

Diagram 



Rrst Element — v y— Last Element 

in Range \ in Range 




Rrst KJXXXX 



Elements to Count 
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LeICountRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Mediumint LelCountRange( pLelBeg, pLelEnd ) 
PLEL pLelBeg; 
PLEL pLelEnd; 

Public Function 

Purpose 

The LeICountRange function returns the number of list elements in the range 
of ListElements pLelBeg through pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element in a range. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element in a range. 

Return Value 

The return value from the LeICountRange function is the number of list 
elements in the range including the first and last ListElements pLelBeg and 
pLelEnd. 

Notes 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeICIientVisitSuccessors 



See Also 

LelClientVisitBwd, LelClientVisitFwd, LelCUentVisitPredecessors, 
LelCllentVisitRange 

Diagram 



first Element < Last Element 

First y Last 
pLel — ' Walk Elements 
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LeICIientVisitSuccessors 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LeiaientVisitSucccssors( pLel, offset, pBlk ) 

PLEL pLel; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The LeICIientVisitSuccessors function walks the list in and calls a ListElement 
client function for each list element visited. The list is walked in a forward 
direction starting with the ListElement succeeding the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 

successor to this element is the first visited, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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LeICIientVisitRange 



Notes 



The client function may return a value but it is ignored. 

pLelBeg and pLelEnd must belong to the same list. 

(If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.) 

See Also 

LelClientVisitBwd, LelClientVisitFwd, LelClientVisitPredecessors, 
LelClientVisitSuccessors 

Diagram 

First Element — \ Last Element 

to Visit pLelBeg \ /to VWt pLelEnd 




First 



Last 



Walk Elements 
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LeICIientVisitRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



Mediumlnt LelClientVisitRange( pLelBeg, pLelEnd, offset, pBlk ) 

PLEL pLelBeg; 

PLEL pLelEnd; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICIientVisitRange function walks the list for a range of LtstElements 
pLelBeg through pLelEnd and calls a ListElement client function for each list 
element visited. 

The Block pBlk contains the client function and an optional list of arguments. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to visit. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to visit, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientVisitRange function is the number of times 
list elements are visited. 
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LeICIientVisitPredecessors 



See Also 

LelClientVisitBwd, LelCUentVisitFwd, LelClltntVisitRange, 
LelClientVisitSuccessors 

Diagram 



Last Element 
to Visit 
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LeICIientVisitPredecessors 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



Void LeiaientVisitPredecessois( pLel, offset, pBlk ) 

PLEL pLel; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICIientVisitPredecessors function walks the list and calls a ListElement 
client function for each list element visited. The list is walked in a backward 
direction starting with the ListElement preceding the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 

predecessor to this element is the first visited, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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LeICIientVisitFwd 



See Also 

LelClientVisitBwd, LelCllentVisitPredecessors, LelClientVisitRange, 
LelCllentVisitSuccessors 

Diagram 



First Element v ^- last Element 



falk Elements 



Lei - 13 



LeICIientVisitFwd 



Summary 

#include ' ^objects.h" 
#lnclude "lelmac.h" 

Void UlClientVisitFwd(pLel, offset, pBlk) 

PLEL pLel; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The LeICIientVisitFwd function walks the list and calls a ListElement client 
function for each list element visited. The list is walked in a forward direction 
(self to last) starting with the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. This is the 

first list element visited, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 

(The list element may be NULL in which case no elements are visited.] 
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LeICIientVisitBwd 



See Also 

LelClientVisitFwd, LelClientVisitPredecessors, LelClientVisitRange, 
LelClientVisttSuccessors 

Diagram 



last Element -v . First Element 

to Visit \ I to Visit pLel 




First -oooo^. _ Last 

Walk Elements 
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LeICIientVisitBwd 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LeiaientVisitBwd( pLel, offset, pBlk ) 

PLEL pLel; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The LeICIientVisitBwd function walks the list and calls a ListElement client 
function for each list element visited. The list is walked in a backward direction 
(self to first) starting with the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement This is the 

first list element visited. 
• offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 

[The list element may be NULL in which case no elements are visited.] 
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LeICIientPrev 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

POBJ LelClientPrev( pLel, offset) 

PLEL pLel; 

Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The LeICIientPrev function returns the client pointer of the preceding list 
element to the ListElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 
offset - The distance in bytes between the ListElement pLel 
and it's client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientPrev function is the client pointer of the 
preceding list element to the ListElement pLel or NULL if pLel is the first 
element. 

See Also 

LelGetClient, LelClientNext 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeICIientPrev function. 
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LeICIientNext 



Summary 

#include "cobjects.h" 
#Include "lelmac.h" 

POBJ LelQientNexK pLel, offset ) 

PLEL pLel; 
Medlumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The LeICIientNext function returns the client pointer of the succeeding list 
element to the ListElement pLel. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 
offset - The distance in bytes between the ListElement pLel 
and it's client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientNext function is the client pointer of the 
succeeding list element to the ListElement pLel or NULL if pLel is the last 
element. 

See Also 

LelGetClient, LelClientPrev 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeICIientNext function. 
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LeICIientFindRange 



Notes 

pLelBeg and pLelEnd must belong to the same list. 

(If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

Diagram 

First Element — \ /— Last Element 

to Visit pLelBeg \ / to Visit pLelEnd 




First r<SXJr<Jr<Jr^. _ ^ 



Walk Elements 
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LeICIientFindRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



POBJ LeiaientFindRange( pLelBeg, pLelEnd, offset, pBlk ) 

PLEL pLelBeg; 

PLEL pLelEnd; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICIientFindRange function walks the list for the range of ListElements 
pLelBeg through pLelEnd and calls a client function for each list element 
visited. The list is walked in a forward direction. The function terminates when 
the client function returns True or the end of the list is reached. If a True value 
is returned, the client pointer of the list element is returned, otherwise NULL is 
returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The function must return a boolean (True/False) value. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to visit. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to visit, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientFindRange function is the client pointer of 
the first list element for which the client function returns True. Otherwise 
NULL is returned. 
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LeICIientDII 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

POBJ LelClientDlHpLel, offset) 

PLEL pLel; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The LeICIientDII function returns the client pointer of the list that the 
ListElement pLel is linked to. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeICIientDII function is the client pointer of the list 
that the ListElement pLel is linked to or NULL if it is not linked to a list. 

See Also 

LelGetDll 

Example 

Please refer to class test procedure TSTLEL. C.TSTDLL. C for an example of the 
use of the LeICIientDII function. 
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LeICIientCount 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Mediumlnt LelClientCounK pLel, offset, pBlk ) 
PLEL pLel; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The LeICIientCount function returns the number of times a ListElement client 
function returns non-zero. The entire list is walked in a forward direction 
starting with the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 
The function must return a Mediumlnt value. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement This is the 

first list element visited, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientCount function is the number of times the 
ListElement client function returns non-zero. 

Notes 

(The list element can be NULL in which case the return value is zero and no 
items are processed.] 
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LeIAsObj 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

POBJ LelAsObj(pLel) 

PLEL pLel; 

Private Function 

A macro is available for this function 

Purpose 

The LeIAsObj function returns a pointer to the Object structure contained by 
the ListElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeIAsObj function is a pointer to the Object structure 
contained by the ListElement class. 

Notes 

The Object pointer can be used to send a message to the client of pLel. 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIAsObj function. 



Lei -2 



Class Reference for ListElement 



Structure Name: 
Abbreviation: 
Class Type: 



ListElement 
Lei 

Inheritable class 



JulianTime 



Tills page is intentionally left blank 



1 
■ 
1 
1 
1 
I 
1 
1 
1 



Jul -64 



JulYearString 



Example 



Jul jul; 

Char prtBuf[5]; 



/* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r get the year string 7 
JulYearString( &jul, prtBuf ); 
printf( "This year is %s\n", prtBuf ); 



The following output will appear to the terminal 
This year is 1987 
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JulYearString 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulYearString(pJul,pStr) 
PJUL pJul; 
PSTR pStr; 

Public Function 

Purpose 

The JulYearString function returns the String pStr filled with the year 
represented by JidianTime pJul. The format is: 
example: 1987 or 1988 
4 characters 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
pStr - Returns the year string. The string should be able to 
hold 4 characters plus a NULL terminator. 

Return Value 

No return value 
Notes 

This function is used to create string output based upon date values. The 
output format can be controlled to any convention by editing the Class Source 
file jul.c and examining the sprintf statement within the function. 

See Also 

JulWeekString, JulMonthString, JulQuarterString 
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JulWeekString 



Example 



Jul jul; 
Char prtBuf[7]; 



I* create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r get the week string */ 
JulWeekString ( &jul, prtBuf ); 
printf( "This Is the %s\n", prtBuf ); 

The following output will appear to the terminal 
This is the 23 Dec 
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JulWeekString 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulWeekString(pJtd,pStr) 
PJUL pJul; 
PSTR pStr; 

Public Function 

Purpose 

The JulWeekString function returns the String pStr filled with the day and 
month represented by JidianTwne pJul. The format is: 
example: 2 Aug or 18 Jul 

1-2 digits left justified + 3 characters 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 
pStr - Returns the week string. The string should be able to 
hold 6 characters plus a NULL terminator. 

Return Value 

No return value 

Notes 

This function is used to create string output based on julian time values. The 
output format can be controlled to any convention by editing the Class Header 
file julmac.h and replacing the weekMonthName ClassData string values with 
any requirement. The output format can further be controlled by editing the 
Class Source file jul.c and examining the sprintf statement within the function. 

See Also 

JulMonthString, JulQuarterString, JulYearString 
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JulValidateDate 



See Also 

JulCalendaiToJulian, JulDateSfcToJulian, JulToDateStr 

Example 



Jul Jul; 

Char dateBuf[11]; 



I* get string from user * 
printf( "Enter date:"); 
gets( dateBuf ); 

I* validate a julian date */ 
if( JulValidateDate( dateBuf ) == True ) 
printf( "Good date\n" ); 

gIsg 

printf( "Bad date\n" ); 



ixample of a bad date is: 
30-2-1987 
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JulValidateDate 



Summary 

#include "cobjects.h" 
#lnclude "julmac.h" 

Bool JulValidateDate( pStr, format ) 

PSTR pStr; 
DateFormat format; 

Public Function 

Purpose 

The JulValidateDate function will validate a date represented by the String 
pStr. The format of the string is controlled by a date format identifier. 

This function is not typical of a class function in that a JidicmTune pointer is 
not the first argument. 

Parameter - Description 



})Str - String containing the date, 

brmat - Date string format. 

date format: 

DF_US > MM-DD-YYYY 
DFJEUROPE > DD-MM-YYYY 
DF_MILITARY > YYYY-MM-DD 

Return Value 

The return value from the JulValidateDate function is True if the date is valid 
and False if the date is invalid. 

Notes 

This function is used to validate date strings prior to converting them to julian 
time. 
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JulToDateStr 



Example 



Jul jul; 

Char dateBuf[11]; 



I* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DFJJS): 

/* convert to a date string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

The following output will appear to the terminal 
This is the date 12-23-1987 
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JulToDateStr 



. Summary 

#lnclude "cobjects.h" 
#include "julmac.h" 

Void JmToDateStr(pJul,pStr, format) 

PJUL pJul; 
PSTR pStr; 
DateFormat format; 

Public Function 

Purpose 

The JulToDateStr function returns the String pStr filled with the date 
represented by JuLianTime pJul. The format of the date string is controlled by 
passing a date format identifier. 

Parameter - Description 



pJul - Pointer to a structure of type JuLianTime. 

pStr - Returns a date string. The string should be able to 

hold 10 characters plus a NULL terminator, 
format - Date string format. 

date format: 

DFJJS > MM-DD-YYYY 
DF.EUROPE > DD-MM-YYYY 
DF_MILITARY > YYYY-MM-DD 

Return Value 

No return value 

See Also 

JulDateStrToJulian, JulValidateDate 
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JulToCalendar 



Example 



Jul jul; 
Mediumlnt year; 
Medium Int month; 
Mediumlnt day; 



r create the JulianTime pointer 7 
JulCalendarToJulian( &jul, 1987, 1, 31 ); 

I* convert the same date back 7 
JulToCalendar( &jul, &year, &month, &day ); 
printf( "date %d-%d-%d\n", month, day, year ); 



The following output will appear to the terminal: 
date 1-31-1987 
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JulToCalendar 



Summary 

#include "cobjects.h" 
#include "julmac.h" 



Void JulToCalendar( pJul, year, month, day ) 

PJUL pJul; 

Mediumlnt *year; 

Medlumlnt *month; 

Mediumlnt *day; 



Public Function 

Purpose 

The JulToCalendar function returns the values of year, month, and day, for the 
JulianTime pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime year, 

year - Returns a 4 digit year. [1583 - 4713] 

month - Returns a 1-2 digit month. [1 - 12] 

day - Returns a 1-2 digit day. [1 - 31] 



Return Value 

No return value 

See Also 

JulCalendarToJulian 
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JulSetMaxDate 



Example 



Jul jul; 



JulSetMaxDate( &jul ); /* set date to maximum 7 

I* check if date is maximum value 7 
if( JullsMaxValue( &jul ) == True ) 

printf( "date is maximum\n" ); 
else 

printf( "date is NOT maxium\n" ); 



The following output will appear to the terminal: 
date is maximum 
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JulSetMaxDate 



Summary 

#Include "cobjects.h" 
#include "julmac.h" 

Void JulSetMaxDate( pjul ) 

PJUL pjul; 

Public Function 

Purpose 

The JulSetMaxDate function places the maximum Julian time value into 
JulianTime pjul. 

Parameter - Description 

pjul - Pointer to a structure of type JulianTime. 

Return Value 

No return value 

Notes 

Use the JulIsMaxValue function to compare against the maximum Julian time 
value. 

The value assigned to pJul is Julian day number 2147483647. 
See Also 

JulIsMaxValue 
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JulSameDayMonth 



Example 



{ 

Jul jul1; 
Jul jul2; 



/* create two juiian dates 7 

JulDateStrToJulian( &jul1, "12-23-1987", DF_US ): 

JulDateStrToJulian( &jul2, "12-23-1934", DF_US ): 

I* see if the date is the same within a year */ 
if( JulSameDayMonth( &jul1 , &jul2 ) = True ) 
printf ( "Same day and month\n" ) ; 

else 

printf( "NOT the same day and month\n" ); 



the following output will appear to the terminal: 
Same day and month 
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JulSameDayMonth 



Summary 

#lnclude "cobjects.h" 
#include "julmac.h" 

Bool JulSameDayMonth( pJull, pjul2 ) 

PJUL pJull; 
PJUL pJul2; 

Public Function 

Purpose 

The JulSameDayMonth function returns True if JulianTtme pJull and 
JulianTtme pJul2 have the same day and month values. The year value can be 
different. 

Parameter - Description 



pJull - Pointer to a structure of type JulianTtme. 
pJul2 - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulSameDayMonth function is True if pJull and 
pJul2 have the same day and month values. The year value can be different. 
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JulQuarterString 



Example 



Jul jul; 

Char prtBuf[13]; 



I* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DFJJS ): 

/* get the quarter string 7 
JulQuarterString( &jul, prtBuf ); 
printf( "This quarter is %s\n", prtBuf ); 

The following output will appear to the terminal 
This quarter is 4th Qtr 1987 
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JulQuarterString 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulQuarterString( pJul, pStr ) 

PJUL pJul; 
PSTR pStr; 

Public Function 

Purpose 

The JulQuarterString function returns the String pStr filled with the quarter 
and year representedby JulianTime pJul. The format is: 
example: 1st Qtr 1987 or 4th Qtr 1988 
12 characters 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 
pStr - Returns the quarter string. Hie string should be able 
to hold 1 1 characters plus a NULL terminator. 

Return Value 

No return value 

Notes 

This function is used to create string output based on Julian time values. The 
output format can be controlled to any convention by editing the Class header 
file julmac.h and replacing the quarterName ClassData string values with any 
requirement. 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulWeekString, JulMonthString, JulYearString 
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JulMonthString 



Example 



Jul jul; 
Char prtBuf[4]; 



f create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

I* get the month string V 
JulMonthString( &jul, prtBuf ); 
printf( "This month is %s\n", prtBuf ); 

The following output will appear to the terminal 
This month is Dec 
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JulMonthString 



Summary 

#include "cobjects.h" 
#include "Julmac.h" 

Void JulMonthString(pJul,pStr) 
PJUL pJul; 
PSTR pStr; 

Public Function 

Purpose 

The JulMonthString function returns the String pStr filled with the month and 
year represented by JidianTime pJul. The format is: 
example: Aug 1988 or Jul 2052 
8 characters 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
pStr - Returns the month string. The string should be able to 
hold 8 characters plus a NULL terminator. 

Return Value 

No return value 

Notes 

This function is used to create string output based on julian time values. The 
output format can be controlled to any convention by editing the Class header 
file julmac.h and replacing the monthName ClassData string values with any 
requirement. 

See Also 

JulWeekString, JulQuarterString, JulYearString 
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JulMonthDayDiff 



Example 



Jul jul; 
Mediumlnt cliff ; 



I* create a julian date V 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

I" see if what the difference is */ 
diff = JulMonthDayDiff( &jul, 12, 1 ); 
printf( "Difference = %d\n", diff ); 

\he following output will appear to the terminal: 
Difference = 23 
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JulMonthDayDiff 



Summary 

#includc "cobjects.h" 
#Include "julmac.h" 

Mediumlnt JulMonthDayDiff ( pJul, mnth, dy ) 
PJUL pJul; 
Mediumlnt mnth; 
Mediumlnt dy; 

Public Function 

Purpose 

The JulMonthDayDiff function returns the number of days between (year of 
pJul)/mnth/dy and JulianTtme pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTtme. 
mnth - A 1-2 digit month. (1 - 12] 
dy - A 1-2 digit day. [1-31] 

Return Value 

The return value from the JulMonthDayDiff function is; (year of pJul)/mnth/dy 
- (minus) pJul. 
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JulMin 



Example 

{ 

Jul jul; 
Jul juh; 
Jul jul2; 

Char dateBuf[11]; 



I* create two julian dates */ 

JulDateStrToJulian( &juh, "12-23-1987", DFJJS ): 

JulDateStrToJulian( &jul2, "10-5-1987", DFJJS ): 

I* evalute the minimum of the two dates 7 
JulMin(&jul,&jul1, &jul2); 

I* print the minimum date */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "minimum date %s\n", dateBuf ); 

The following output will appear to the terminal: 
minimum date 10-5-1987 
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JulMin 



Summary 

#lnclude "cobjects.h' 
#include "julmac.h" 



Void 
PJUL 
PJUL 
PJUL 



JulMin( pJul, pJull, pju!2 ) 



pJul; 
pJull; 
pJn!2; 



Public Function 

A macro Is available for this function 

Purpose 

The JulMin function places the minimum of JidianTime pJull and JulianTime 
pJul2 into JidianTime pJul. 

Parameter - Description 

pJul - Returned minimum of two Julian time values. 
pJull - Pointer to a structure of type JidianTime. 
pJul2 - Pointer to a structure of type JidianTime. 

Return Value 

No return value 

See Also 

JulMax 
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JulMax 



Example 

{ 

Jul jul; 
Jul juh; 
Jul jul2; 

Char dateBuf[11]; 



r create two julian dates */ 

JulDateStrToJulian( &jul1, "12-23-1987", DF_US ): 

JulDateStrToJulian( &jul2, "10-5-1987", DF_US ): 

I* evalute the maximum of the two dates */ 
JulMax(&jul, &jul1, &jul2); 

r print the maximum date */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "maxium date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal: 
maximum date 12-23-1987 



Jul -41 



JulMax 



Summary 

#include "cobjects.h" 
#lnclude "julmac.h" 



Void JulMax( pJul, pJull, pjul2 ) 

PJUL pJul; 

PJUL pJull; 

PJUL pJul2; 



Public Function 

A macro is available for this function 

Purpose 

The JulMax function places the maximum of JulianTime pJull and JulianTime 
pJul2 into JulianTime pJul. 

Parameter - Description 



pJul - Returned maximum of two Julian time values. 
pJull - Pointer to a structure of type JulianTime. 
pJul2 - Pointer to a structure of type JulianTime. 

Return Value 

No return value 

Notes 

pJull or pJul2 can be any Julian time value. 
See Also 

JulMin 
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JullsMaxValue 



Example 



Jul jul; 



JulSetMaxDate( &jul ); r set date to maximum 7 

I* check if date is maximum value 7 
if( JullsMaxValue( &jul ) == True ) 

printf( "date is maximum\n" ); 
else 

printf( "date is NOT maxiurmn" ); 

The following output will appear to the terminal: 
date is maximum 



Jul -39 



JullsMaxValue 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Bool JulIsMaxValue( pjul ) 

PJUL pJul; 

Public Function 

A macro Is available for this function 

Purpose 

The JullsMaxValue function determines if JulianTime pJul is equal to the 
maximum Julian time value. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JullsMaxValue function is True if pJul is the 
maximum Julian time value, or False if not. 

Notes 

Use the JulSetMaxDate function to set the maximum julian time value. 

See Also 

JulSetMaxDate 
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JullsLeapYear 



Example 



Jul jul; 



I* see if a year is a leap year 7 
if( JullsLeapYear( 1987 ) == True ) 
printf( "Is Leap Year\n" ); 

else 

printf( "Is Not Leap Year\n" ); 



The following output will appear to the terminal: 
Is Not Leap Year 
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JullsLeapYear 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Bool JulIsLeapYeai( yr ) 

Mediumlnt yr; 

Public Function 

Purpose 

The JullsLeapYear function determines if the year yr is a leap year. 

This function is not typical of a class function in that a JulianTinie pointer is 
not the first argument. 

Parameter - Description 

yr A 4 digit year. [1583 - 4713] 

Return Value 

The return value from the JullsLeapYear function is True if the year yr is a leap 
year and False if yr is not. 
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Jullnit 



Example 



{ 

Jul jul; 
Medium Int year; 
Medium Int month; 
Mediumlnt day; 
Char dateBuf[11]; 



Jullnit( &jul ); I* initialized to zero 7 



I* create a date string 7 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "%s\n", dateBuf ); 



The following output will appear to the terminal: 
1-1-1583 
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Jullnit 



Summary 

#lnclude "cobjects.h" 
#include "julmac.h" 

Void Jullnit(pjul) 
PJUL pJul; 

Public Function 

A macro is available for this function 

Purpose 

The Jullnit function initializes the contents of JulianTime pJul to the beginning 
of the Gregorian calendar (rounded up a year), January 1, 1583, or Julian day 
[2299239]. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

No return value 



t 
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JulGetSystemJulianDay 



Example 



Jul Jul; 
Mediumlnt day; 
Mediumlnt month; 
Mediumlnt year; 



/* get the system time 7 
JulGetSystemJulianDay( &jul ); 

I* print the system date 7 

JulConvertJulian( &jul, &year, &month, &day ); 

printf( "system date %d-%d-%d\n H , month, day, year ); 



The following output will appear to the terminal: 
system date [computers date] 
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JulGetSystemJulianDay 



Summary 

#include "cobJects,h" 
#include "Julmac.h" 

Void JulGetSystemJulianDay( pjul ) 

PJUL pJul; 

Public Function 

Purpose 

The JulGetSystemJulianDay function places the Julian time value of the 
computers clock into JulkmTime pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

No return value 
Notes 

This function uses the standard C function ctimeO and converts this returned 
string into a Julian time value. 



Jul - 32 



JulDiffL 



Example 



Jul juM; 
Jul jul2; 



1* create two julian date */ 

JulDateStrToJulian( &juh, "12-30-1987", DF_US ): 

JulDateStrToJulian( &jul2, "12-23-1987", DF_US ): 

/* get the number of days between the two dates */ 

/* jull - jul2 = difference */ 

printf( "Difference = %d\n", JulDiff( &juh, &jul2 ) ); 

The following output will appear to the terminal 
Difference = 7 
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JulDiffL 



Summary 



#include "cobjects.h' 
#include "julmac.h" 



Laigelnt 

PJUL 
PJUL 



JulDiffL(pJull,pJul2) 

pJull; 

pJul2; 



Public Function 

A macro is available for this function 

Purpose 

The JulDiffL function returns JulianTime pJull minus JidianTime pJul2. 

Parameter - Description 

pJull - Pointer to a structure of type JulianTime. 
pJul2 - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulDiffL function is the number of days between the 
two julian time values. 



This function is used to determine the number of days between two dates. This 
function should be used if a difference in days in excess of 89 years (days > 
32000) is expected. 

See Also 

JulDiff 



Notes 
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f 

Jul jul1; 
Jul jul2; 



I* create two julian date 7 

JulDateStrToJulian( &jul1, "12-30-1987", DF_US ): 

JulDateStrToJulianf &jul2, "12-23-1987", DF_US ): 

I* get the number of days between the two dates V 

r iuM - jul2 = difference */ 

pnntf( "Difference = %d\n", JulDiff( &jul1, &jul2 ) ); 

The following output will appear to the terminal 
Difference = 7 



JulDiff 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Mcdiumlnt JulDiff ( pJull, pjul2 ) 
PJUL pJull; 
PJUL pJul2; 

Public Function 

A macro is available for this function 

Purpose 

The JulDiff function returns JulianTtme pJull minus JulianTime pJul2. 

Parameter - Description 



pJull - Pointer to a structure of type JulianTime. 
pJul2 - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulDiff function is the number of days between two 
Julian time values. 

Notes 

This function is used to determine the number of days between two dates. If 
the difference is in excess of 89 years (days <= SHRT_MAX or days > 
SHRT_MAX) the JulDiffL function should be used. 

See Also 

JulDiffL 
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JulDayslnYear 



Example 

{ 

Jul jul; 



I* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r print the days in the above year 7 

printf( "days in year = %s\n", JulDayslnYear( &jul ) ); 

\he following output will appear to the terminal: 
days in year = 365 



Jul -27 



JulDayslnYear 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Mediumlnt JulDaysInYear( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDayslnYear function returns the number of days in the year of 
JulianTtme pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTtme. 

Return Value 

The return value from the JulDayslnYear function is the number of days in the 
year of JidianTime pJul. 

See Also 

JulDaysInMonth, JulDaysInQuarter 
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JulDavslnQuarter 



Example 



Jul Jul; 



I* create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r print the days in the above quarter */ 

printf( "days in quarter = %s\n", JulDayslnQuarter( &jul ) ); 

\he following output will appear to the terminal: 
days in quarter = 92 
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JulDaysInQuarter 

Summary 

#include "cobjects.h" 
#include "julmac.h" 

Mediumlnt JulDaysInQuarter( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDaysInQuarter function returns the number of days in the quarter of 
JulianTime pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulDaysInQuarter function is the number of days in 
the quarter of JulianTime pJul. 

Notes 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulDaysInMonth, JulDaysInYear 



Jul -24 



JulDayslnMonth 



Example 



Jul jul; 



I* create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

I* print the days in the above month 7 

printf( "days in month = %s\n", JulDayslnMonth( &jul ) ); 

Vhe following output will appear to the terminal: 
days in month = 31 
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JulDayslnMonth 



Summary 

#include "cobjects.h" 
#lnclude "julmac.h" 

Mediumlnt JulDaysInMonth( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDayslnMonth function returns the number of days in the month of 
JultanTime pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulDayslnMonth function is the number of days in 
the month represented by JulianTime pJul. 

Notes 

The return value from the JulDayslnMonth function is constant except for 
February which has 28 or 29 days dependent upon whether it is a leap year or 
not. 

See Also 

JulDaysInQuarter, JulDaysInYear 
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JulDayOfYear 



Example 



Jul jul; 



I* create a julian date */ 

JulDateStrToJulian( &]ul, "12-23-1987", DF_US ): 

r get the day of the year */ 

printf( "Day of year = %d\n", JulDayOfYear( &jul ) ); 

Vhe following output will appear to the terminal 
Day of year = 357 
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JulDayOfYear 



Summary 

#indude "cobjects.h" 
#include "julmac.h" 

Mediumlnt JulDayOfYeai( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDayOfYear function returns the day of the year for JulianTime pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulDayOfYear function is the day of the year in the 
range 1-365 (366 if leap year). 

See Also 

JulDayOfWeek 
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JulDayOfWeek 



Example 



Jul jul; 



r create a julian date */ 

JulDateStrToJulian( &jul, "1 2-23-1 987", DF_US ): 

I* get the day of the week */ 

printf( "Day of week = %d\n", JulDayOfWeek( &jul ) ); 

\he following output will appear to the terminal 
Day of week = 3 
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JulDayOfWeek 



Summary 

#lnclude "cobjects.h" 
#include 'Julmach" 

Mediumlnt JulDayOfWeek( pTul ) 
PJUL pJul; 

Public Function 

A macro is available for this function 

Purpose 

The JulDayOfWeek function returns the day of week number for the JulianTtme 
pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JidumTime. 

Return Value 

The return value from the JulDayOfWeek function is the day of week number 
in the range 0-6. 



range: 

0 - Sunday 

1 - Monday 

2 - Tuesday 

3 - Wednesday 

4 - Thursday 

5 - Friday 

6 - Saturday 

See Also 

JulDayOfYear, JuTToDateStr 
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JulDateStrToJulian 



See Also 



JulTcDateStr, JuIValidateDate 



Example 



Jul jul; 
Medium Int year; 
Medium Int month; 
Medium Int day; 



I* create an JulianTime pointer from a date */ 
JulDateStrToJulian( &jul, "12-23-1987", DF_US ); 

I* convert the JulianTime pointer back */ 
JulToCalendar( &jul, &year, &month, &day ); 
printf( "date %d-%d-%d\n", month, day, year ); 



The following output will appear to the terminal: 
date 12-23-1987 
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JulDateStrToJulian 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulDateStrToJulian( pJul, pStr, format ) 

PJUL pJul; 
PSTR pStr; 
DateFormat format; 

Public Function 

Purpose 

The JulDateStrToJulian function creates JidianTime pJul from the String pStr 
which contains a date. The format of the date in the string is controlled by 
passing a date format identifier. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
pStr - Contains the string of the specified format, 
format - Date string format. 

date format: 

DF.US > MM-DD-YYYY 
DF_EUROPE > DD-MM-YYYY 
DF_MILITARY > YYYY-MM-DD 

Return Value 

No return value 

Notes 

This function does no error checking and it is presumed that the caller uses 
JuIValidateDate for error checking. 

This routine is used to directly convert date strings to Julian time. 
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JulCopy 



Example 



Jul julS; 
Jul julD; 
Char dateBuf[11]; 



I* create a julian date 7 

JulDateStrToJulian( SjulS, "12-23-1987", DF_US ): 

I* copy the value 7 
JulCopy( SjulD, &julS ); 

I* lets print the copy - its the same! 7 
JulToDateStr( &julD, dateBuf, DF_US ); 
printf( "Copied date %s\n", dateBuf ); 



The following output will appear to the terminal 
Copied date 12-23-1987 
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JulCopy 



Summary 

#include "cobjects.h" 
#include "julmac.h" 



Void 
PJUL 




PJUL pJulS; 
Public Function 

A macro is available for this function 

Purpose 

The JulCopy function copies the contents of the source JulkmTime pJulS to the 
destination JulianTtme pJulD. 

Parameter - Description 

pJulD - Destination pointer to a structure of type JidkuiTtme. 
pJulS - Source pointer to a structure of type JidiariTime. 

Return Value 

No return value 
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JulCalendarToJulian 



See Also 

JulToCalendar 

Example 



Jul jul; 

Char dateBuf[11]; 



r create the JulianTime pointer 7 
JulCalendarToJulian( &jul, 1987, 1, 31 ); 

r create a date string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "%s\n", dateBuf ); 

The following output will appear to the terminal: 
1-31-1987 
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JulCalendarToJulian 



Summary 

#include "cobjects.h" 
#include "julmac.h" 



Void JulCalendarToJulian( pJul, year, month, day ) 

PJUL pJul; 

Medlumlnt year; 

Mediumlnt month; 

Mediumlnt day; 



Public Function 

Purpose 

The JulCalendarToJulian function converts the values of year, month, and day 
to the JulianTime pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 

year - A 4 digit year. [1583-4713] 

month - A 1-2 digit month. [1 - 12] 

day - A 1-2 digit day. [1-31] 



Return Value 

No return value 
Notes 

This function does no error checking and it is presumed that the caller uses 
JuTValidateDate for error checking. 

This function is used to create a Julian time value which can be later used by 
other JulianTime routines. 

[Year must be in the range [1583:4713].] 

[Month must be in the range [1:12].] 

[Day must be a valid day for the month and year specified.] 
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JulAddYears 



Example 



Jul jul; 

Char dateBuf[11]; 



r create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r subtract 2 years from this date */ 
JulAddYears( &jul, (-2) ); 

r convert the julian date to a string V 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

The following output will appear to the terminal: 
This is the date 12-23-1985 



Jul - 11 



JulAddYears 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void Jul AddYears( pJul, yr ) 

PJUL pJul; 
Mediumlnt yr; 

Public Function 

Purpose 

The JulAddYears function adds to or subtracts from JidianTime pJul a number 
of years yr. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
yr - The number of years to be added. If negative then the 

number of years are subtracted. 

Return Value 

No return value 

See Also 

JulAddDays, JulAddDaysL, JulAddMonths, JulAddQuarters 
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JulAddQuarters 



Example 



Jul jul; 

Char dateBuf[H]; 



I* create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r subtract 2 quarters from this date */ 
JulAddQuarters( &jul, (-2) ); 

r convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal: . 
This is the date 6-23-1987 
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JulAddQuarters 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddQuarters( pJul, qtrs ) 

PJUL pJul; 
Mediumlnt qtrs; 

Public Function 

Purpose 

The JulAddQuarters function adds to or subtracts from JulianTime pJul a 
number of calendar quarters qtrs. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 

qtrs - The number of calendar quarters to be added. If 

negative then the number of calendar quarters are 

subtracted. 

Return Value 

No return value 

Notes 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulAddDays, JulAddDaysL, JulAddMonths, JulAddYears 



Jul -8 



JulAddMonths 



Example 



Jul jul; 

Char dateBuf[11]; 



I* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DFJJS ): 

r add 1 month to date V 
JulAddMonths( &jul, 1 ); 

r convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DFJJS ); 
printf( "This is the date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal: 
This is the date 1-23-1988 
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JulAddMonths 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddMonths( pJul, mnth ) 

PJUL pJul; 
Mediumlnt mnth; 

Public Function 

Purpose 

The JulAddDays function adds to or subtracts from JulianTime pJul a number 
of months mnth. 

Parameter - Description 

pJui - Pointer to a structure of type JulianTime. 
mnth - The number of months to be added. If negative then 
the number of months are subtracted. 

Return Value 

No return value 

Notes 

If a date overruns the end of the month the last day of the month is used. 
See Also 

JulAddDays, JulAddDaysL, JulAddQuarters, JulAddYears 
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Jul Add Day sL 



Example 



Jul jul; 

Char dateBuf[11]; 



r create a julian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

I* subtract 250 years from date 7 
JulAddDaysL( &jul, (-91250) ); 

I* convert the julian date to a string 7 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 



The following output will appear to the terminal: 
This is the date 2-21-1738 
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JulAddDaysL 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddDaysL(pJul,dy) 
PJUL pJul; 
Largelnt dy; 

Public Function 

A macro is available for this function 

Purpose 

The JulAddDaysL function adds to or subtracts from JulianTime pJul a 
number of days dy. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 
dy - The number of days to be added. If negative then the 

number of days are subtracted. 

Return Value 

No return value 

Notes 

Use this function if numbers exceeding 89 years (dy > 32,767 days) are 
encountered. 

See Also 

JulAddDays, JulAddMonths, JulAddQuarters, JulAddYears 
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JulAddDays 



Example 



Jul jul; 

Char dateBuf[11]; 



r create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

I* subtract 1 0 days from date 7 
JulAddDays( &jul, (-10)); 

I* convert the julian date to a string 7 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

The following output will appear to the terminal: 
This is the date 1 2-1 3-1 987 
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JulAddDays 



Summary 

#lnclude "cobjects.h" 
#lnclude "julmac.h" 

Void JulAddDays(pJul / dy) 
PJUL pJul; 
Mediumlnt dy; 

Public Function 

A macro Is available for this function 

Purpose 

The JulAddDays function adds to or subtracts from JidkmTime pJul a number 
of days dy. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
dy - The number of days to be added. If negative then the 

number of days are subtracted. 

Return Value 

No return value 

Notes 

If values greater than 89 years (dy > SHRT_MAX) are expected the writer 
should use the JulAddDaysL function. 

See Also 

JulAddDaysL, JulAddMonths, JulAddQuarters, JulAddYears 
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Class Reference for JulianTime 

Structure Name: JulianTime 
Abbreviation: Jul 
Class Type: Primitive 
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GrfVisitVtxClientlnTopOrderFwd 



See Also 

GrfEdgC.Uent, GrfVisitVtxClient, GrfVisitVtxCllentlnTopOrderBwd 

Diagram 



Walk the Vertices 
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GrfVisitVtxClientlnTopOrderFwd 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 



Void GrfVisitVbcaientInTopOrderFwd( pGrf, offset, pBlk ) 

PGRF pGrf; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The GrfVisitVtxClientlnTopOrderFwd function walks all the vertices of the 
Graph pGrf and calls a Vertex client function for each vertex visited. The graph 
is walked in forward topological order. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

To use the GrfVisitVtxClientlnTopOrderFwd function the graph must first be 
sorted using the GrfDoTopologicalSort function. 

The client function may return a value but it is ignored. 
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GrfVisitVtxClientlnTopOrderBwd 



See Also 

GrfVisitEdgClient, GrfVisitVtxClient, GrMsitVtxCUenfcnTopOrderFwd 

Diagram 



Walk the Vertices 
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GrfVisitVtxClientlnTopOrderBwd 



Summary 

#lnclude "cobjects.h" 
#include "grfmac.h" 



PGRF GrfVisitVtxaientInTopOrderBwd( pGrf, offset, pBlk ) 

Mediumlnt offset; 
PBLK pBlk; 



Public Function 

Purpose 

The GrfVisitVtxClientlnTopOrderBwd function walks all the vertices of the 
Graph pGrf and calls a Vertex client function each vertex visited. The graph is 
walked in backward topological order. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

To use the GrfVisitVtxClientlnTopOrderBwd function the graph must first be 
sorted using the GrfDoTopologicalSort function. 

The client function may return a value but it is ignored. 
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GrfVisitVtxClient 



See Also 

GrfVisitEdgClient, GrfVisitVtxClientlnTopOrderBwd, 
GrfVisitVtxClientlnTopOrderFwd 

Diagram 



Walk the Vertices Wk „ tte 0l(ler 
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GrfVisitVtxClient 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Void GrfVisitVtxClienK pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitVtxClient function walks the clients of the vertices of the Graph 
pGrf and calls a Vertex client function for each vertex visited. The Block pBlk 
contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The walk of the vertices is in the order that they were added. 
The client function may return a value but it is ignored. 
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GrfVisitEdgClient 



See Also 

GrfVisitVtxClient, GrfVisitVtxClientlnTopOrderBwd, 
GrfVisitVtxCUentlnTopOrderFwd 

Diagram 



Walk the Edges Walked in the Order 
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GrfVisitEdgClient 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Void GrfVisitEdgClienKpGrf, offset, pBlk) 

PGRF pGrf; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitEdgClient function walks the clients of the edges of the Graph pGrf 
and calls an Edge client function for each edge visited. The Block pBlk contains 
the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The walk of the edges is in the order that they were added. 
The client function may return a value but it is ignored. 
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Grf Send Destroy 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Void Grf SendDestroy( pGrf ) 

PGRF pGrf; 

Public Function 

Purpose 

The GrfSendDestroy function sends a message to the client of the Graph pGrf 
asking it to destroy the graph. The Graph client function will receive this 
message and should deinitialize or destroy the graph. This message function 
should be included in the Graph client message array. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

No return value 
Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfSendDestroy function. 
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Grflnit 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Void Grflnit(pGrf) 
PGRF pGrf; 

Public Function 

Purpose 

The Grflnit function initializes the Graph pGrf. The Grflnit function should be 
the first function called when using the Graph class. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

No return value 

Notes 

The last function to call when using the Graph class is GrfDelnit 

See Also 

GrfDelnit, GrfDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Grflnit function. 
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GrfGetClient 



Summary 

#mclude "cobjects.h" 
#lnclude "grfmac.h" 

POBJ Grf Getaient( pGrf, offset ) 

PGRF pGrf; 
Mediumlnt offset; 

Public Function 

Purpose 

The GrfGetClient function returns a pointer to the client of the Graph pGrf . 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 
offset - The distance in bytes between the Graph pGrf and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfGetClient function is a pointer to the client of the 
Graph pGrf. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfGetClient function. 
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GrfFindVtxGlient 



See Also 

GrfFindEdgClient 

Diagram 
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GrfFindVtxClient 



Summary 

#include "cobjects.b" 
#lnclude "grfmac.h" 

POBJ GrfFindVtxaienK pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfFindVtxClient function walks all vertices in the Graph pGrf and calls a 
Vertex client function for each vertex traversed. The function terminates when 
the client function returns True or the last vertex is reached. If a True value is 
returned, the client pointer of the vertex is returned, otherwise NULL is 
returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/False) value. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfFindVtxClient function is a pointer to the Vertex 
client structure for the vertex for which the client function returns True. If no 
vertex is found then NULL is returned. 

Notes 

The function should return True for the GrfFindVtxClient function to return 
True. 
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See Also 

GrfFindVtxClient 

Diagram 



GrfFindEdgClient 
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GrfFindEdgClient 



Summary 

#include "cobjects.h" 
#lnclude "grfmac.h" 

POBJ GrfFindEdgaient( pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfFindEdgClient function walks all edges in the Graph pGrf and calls an 
Edge client function for each edge traversed. The function terminates when the 
client function returns True or fee last edge is reached. If a True value is 
returned, the client pointer of the edge is returned, otherwise NULL is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/False) value. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfFindEdgClient function is a pointer to the Edge 
client structure for the edge for which the client function returns True. If no 
edge is found then NULL is returned. 

Notes 

The function should return True for the GrfFindEdgClient function to return 
True. 
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GrfDoTopologicalSort 



Diagram 



Sort Vertices 
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GrfDoTopologicalSort 



Summary 

#lnclude "cobjects.h" 
#include "grfmac.h" 

Bool GrfDoTopologicalSort( pGrf ) 

PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

Hie GrfDoTopologicalSort function sorts the vertices in the Graph pGrf in 
forward and backward topological order. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

Return Value 

The return value from the GrfDoTopologicalSort function is False if the Graph 
pGrf is acyclic or True if it is not. 

Notes 

Use the GrfDoTopologicalSort function prior to calling the functions 
GrfVisitVtxClientlnTopOrderBwd or GrfVisitVtxClientlnTopOrderFwd. There 
can be more than one ordering of the vertices which is in topological order. 

See Also 

GrfDoBasicTopologicalSort, GrfVisitVtxClientlnTopOrderBwd, 
GrfVisitVtxClientlnTopOrderFwd 
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GrfDestroy 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Void Gr£Destroy( pGrf ) 

PGRF pGrf; 

Public Function 

Purpose 

The GrfDestroy function deallocates the memory used by the object and 
deinitializes the Graph object. The Graph pGrf should not be referenced after 
this function call since its memory will have been deallocated. 

Any vertices or edges linked to the graph will be unlinked before destroying the 
object. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

No return value 

Notes 

[pGrf must not have a sub-object.] 
See Also 

GrfDelnit, Grflnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfDestroy function. 
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GrfDelnit 



Summary 

#include "cobjects.h" 
#include "grfinach" 

Void GrfDelnit(pGrf) 
PGRF pGrf; 

Public Function 

Purpose 

The GrfDelnit function deinitializes the Graph object. The GrfDelnit function 
should be the last function called when using the Graph class. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

No return value 
Notes 

The first function to call when using the Graph class is Grflnit. 

The vertices and edges can be removed from the graph by calling the GrfClear 
function. 

[pGrf must not contain any vertices.) 
(pGrf must not contain any edges.] 

See Also 

GrfClear, GrfDestroy, Grflnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfDelnit function. 
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GrfCountVtx 



Diagram 

Number of Vertices = 10 
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ibjects.h" 
fmac.h" 

GrfCountVtx( pGrf ) 

pGrf; 

•n 

Ulable for this function 



titVtx function returns the number of vertices in the Graph pGrf. 

Description 

Pointer to a structure of type Graph. 

ue 

'alue from the GrfCountVtx function is the number of vertices in 
Grf. 

g 



GrfCountEdg 

Diagram 

Number of Edges = 15 
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GrfCountEdg 



Summary 

#lnclude "cobjects.h" 
#include "grfmac.h" 

Mediumlnt GrfCountEdg( pGrf ) 
PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

The GrfCountEdg function returns the number of edges in the Graph pGrf. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

The return value from the GrfCountEdg function is the number of edges in the 
Graph pGrf. 

See Also 

GrfCountVtx 
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GrfClear 



Summary 

#lnclude "cobjects.h" 
#lnclude "grfmac.h" 

Void GrfClear(pGrf) 
PGRF pGrf; 

Public Function 

Purpose 

The GrfClear function unlinks all vertices and edges from the Graph pGrf. The 
topological sort arrays are also cleared. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfClear function. 
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GrfAsVtxDII 



Summary 

#include "cobjects.h 1 
#lnclude "grfmac.h" 



PDLL 

PGRF 



GrfAsVtxDU(pGrf) 
pGrf; 



Friend Function 

Purpose 

The return value from the GrfAsVtxDII function is a pointer to the List 
structure contained by the Graph pGrf. The list contains the vertices of pGrf . 



Return Value 

The return value from the GrfAsEdgDll function is a pointer to the structure of 
type List contained by the Graph class. The list contains the vertices of pGrf. 

See Also 

GrfAsEdgDll, GrfAsObj 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsVtxDII function. 



Parameter - Description 



pGrf 



Pointer to a structure of type Graph. 



Example 
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GrfAsObj 



Summary 

#include "cobjects.h" 
#lnclude "grfmac.h" 

POBJ GrfAsObj(pGrf) 
PGRF pGrf; 

Private Function 

Purpose 

The GrfAsObj function returns a pointer to the Object structure contained by 
the Graph pGrf . 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

The return value from the GrfAsObj function is a pointer to the Object 
structure contained by the Graph class. 

Notes 

The Object pointer can be used to send a message to the client of the Graph. 

See Also 

GrfAsEdgDU, GrfAsVtxDll 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsObj function. 
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GrfAsEdgDII 



Summary 

#include "cobjects.h 1 
#include "grfmac.h" 



PDLL 

PGRF 




Friend Function 

Purpose 

The return value from the GrfAsEdgDU function is a pointer to the List 
structure contained by the Graph pGrf. The list contains the edges of pGrf . 



Return Value 

The return value from the GrfAsEdgDII function is a pointer to the structure of 
type List contained by the Graph class. The list contains the edges of pGrf. 

See Also 

GrfAsObj, GrfAsVtxDll 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsEdgDII function. 



Parameter - Description 



pGrf 



Pointer to a structure of type Graph. 



Example 
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GrfAnyCycles 



Diagram 
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Grf Any Cycles 



Summary 

#include "cobjects.h" 
#include "grfmac.h" 

Bool Grf AnyCydes( pGrf ) 
PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

The GrfAnyCycles function determines if the graph is acyclic. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 
Return Value 

The return value from the GrfAnyCycles function is False if the Graph pGrf is 
acyclic or True if it is not. 
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Class Reference for Graph 



Structure Name: 
Abbreviation: 
Class Type: 



Graph 
Grf 

Inheritable class 



EdgUpdateOutVtx 



Diagram 

Update the outgoing Vertex 
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EdgUpdateOutVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgUpdateOutVtx( pEdg, pVtxO ) 

PEDG pEdg; 
PVTX pVtxO; 

Public Function 

Purpose 

The EdgUpdateOutVtx function replaces the current outgoing vertex for the 
Edge pEdg with the Vertex pVtxO. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

pVtxO - Pointer to a structure of type Vertex where this is the 

outgoing vertex. An outgoing vertex has the edge as an 

incoming edge. 

Return Value 

No return value 
Notes 

[pEdg must be linked to a graph.] 

[pEdg must be linked to two vertices.] 

[The Vertex pVtxO must be linked to a graph.] 

See Also 

EdgUpdatelnVtx 
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EdgUpdatelnVtx 



Diagram 
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EdgUpdatelnVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgUpdateInVtx( pEdg, pVtxI ) 

PEDG pEdg; 
PVTX pVtxI; 

Public Function 

Purpose 

The EdgUpdatelnVtx function replaces the current incoming vertex for the 
Edge pEdg with the Vertex pVtxI. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

pVtxI - Pointer to a structure of type Vertex where this is the 

incoming vertex. An incoming vertex has the edge as 

an outgoing edge. 

Return Value 

No return value 

Notes 

[pEdg must be linked to a graph.] 

[pEdg must be linked to two vertices.] 

[The Vertex pVtxI must be linked to a graph.] 

See Also 

EdgUpdateOutVtx 
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EdgSend Destroy 



Summary 

#include "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgSendDestroy( pEdg ) 

PEDG pEdg; 

Public Function 

A macro Is available for this function 

Purpose 

The EdgSendDestroy function sends a message to the client of the Edge pEdg 
asking it to destroy the edge. The Edge client function will receive this message 
and should deinitialize or destroy the edge. This message function should be 
included in the Edge client message array. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgSendDestroy function. 



Edg-34 



Edglnit 

Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void Edglnit(pEdg) 
PEDG pEdg; 

Public Function 

Purpose 

The Edglnit function initializes the Edge object. The Edglnit function should be 
the first function called when using the Edge class. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Notes 

The last function to call when using the Edge class is EdgDelnit. 

See Also 

EdgDelnit, EdgDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Edglnit function. 
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EdglnGrf 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Bool EdglnGrf ( pEdg ) 

PEDG pEdg; 

Public Function 

A macro Is available for this function 

Purpose 

The EdglnGrf function determines if the Edge pEdg is linked to a Graph. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdglnGrf function is True if the Edge pEdg is linked 
to a Graph, otherwise False is returned. 

See Also 

EdgGetGrf 
Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdglnGrf function. 
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EdgHasVertices 



Summary 

#include "cobjects.h" 
#lnclude "edgmac.h" 

Bool EdgHasVertices( pEdg ) 

PEDG pEdg; 

Public Function 

Purpose 

The EdgHasVertices function determines if the Edge pEdg has any vertices 
linked to it. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgHasVertices function is True if the Edge pEdg 
has any vertices, otherwise False is returned. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgHasVertices function. 
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EdgGetVertices 



Diagram 
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EdgGetVertices 



Summary 

#include "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgGetVertices( pEdg, ppVtxI, ppVtxO ) 

PEDG pEdg; 
PVTX *ppVtxI; 
PVTX *ppVtxO; 

Public Function 

A macro is available for this function 

Purpose 

The EdgGetVertices function returns the incoming Vertex pVtxI and the 
outgoing Vertex pVtxO for the Edge pEdg. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

ppVtxI - Returned pointer to a structure of type pointer to 
Vertex where this is the incoming vertex. An incoming 
vertex has the edge as an outgoing edge. 

ppVtxO - Returned pointer to a structure of type pointer to 
Vertex where this is the outgoing vertex. An outgoing 
vertex has the edge as an incoming edge. 

Return Value 

No return value 

See Also 

EdgGetlnVtx, EdgGetOutVtx 
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EdgGetOutVtx 



Diagram 
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EdgGetOutVtx 



Summary 

#include "cobjects.h' 
#include "edgmac.h" 



PVTX 
PEDG 



EdgGetOutVtx( pEdg ) 

pEdg; 



Friend Function 

A macro Is available for this function 



Purpose 



The EdgGetOutVtx function returns a pointer to the outgoing Vertex that the 
Edge pEdg is linked to. 

Parameter - Description 



Return Value 

The return value from the EdgGetOutVtx function is a pointer to a Vertex 
structure. This vertex is the outgoing Vertex to pEdg. An outgoing vertex has 
the edge as an incoming edge. 

See Also 

EdgGetlnVtx 



pEdg 



Pointer to a structure of type Edge. 
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EdgGetNextOut 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

PEDG EdgGetNextOut(pEdg) 
PEDG pEdg; 

Friend Function 

A macro Is available for this function 

Purpose 

The EdgGetNextOut function returns a pointer to the successor outgoing Edge 
from the Edge pEdg or NULL if none exists. This successor edge is the next 
edge in a list of outgoing edges for a vertex. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgGetNextln function is a pointer to an Edge 
structure or NULL. This edge is the successor outgoing edge to the Edge pEdg. 

See Also 

EdgGetNextln 
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EdgGetNextln 



Diagram 

Get next incoming Edge for Vertex to pEdg 
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EdgGetNextln 



Summary 

#include "cobjects.h' 
#include "edgmac.h" 



PEDG 
PEDG 



EdgGetNextIn( pEdg ) 
pEdg; 



Friend Function 

A macro Is available for this function 



Purpose 



The EdgGetNextln function returns a pointer to the successor incoming Edge 
from the Edge pEdg or NULL if none exists. This successor edge is the next 
edge in a list of incoming edges for a vertex. 

Parameter - Description 



Return Value 

The return value from the EdgGetNextln function is a pointer to an Edge 
structure or NULL. This edge is the successor incoming edge to the Edge pEdg. 

See Also 

EdgGetNextOut 



pEdg 



Pointer to a structure of type Edge. 
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EdgGetlnVtx 



Diagram 



Get incoming Vertex 
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EdgGetlnVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

PVTX EdgGetInVtx( pEdg ) 

PEDG pEdg; 

Friend Function 

A macro Is available for this function 

Purpose 

The EdgGetlnVtx function returns a pointer to the incoming Vertex that the 
Edge pEdg is linked to. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgGetlnVtx function is a pointer to a Vertex 
structure, otherwise NULL is returned. This vertex is the incoming Vertex to 
pEdg. An incoming vertex has the edge as an outgoing edge. 

See Also 

EdgGetOutVtx, EdgGetVertices 
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EdgGetGrf 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

PGRF EdgGetGrf(pEdg) 
PEDG pEdg; 

Friend Function 

A macro is available for this function 

Purpose 

The EdgGetGrf function returns a pointer to the graph that the Edge pEdg is 
linked to. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgGetGrf function is a pointer to a Graph structure 
or NULL if not linked to a graph. 

See Also 

EdglnGrf 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgGetGrf function. 
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EdgGetClient 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

POBJ EdgGetQient( pEdg, offset ) 

PEDG pEdg; 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The EdgGetClient function returns a pointer to the client of the Edge pEdg. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 
offset - The distance in bytes between the Edge pEdg and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the EdgGetClient function is a pointer to the client of the 
Edge pEdg. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgGetClient function. 
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EdgDisconnectFromVertices 

Diagram 
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from Graph 
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EdgDisconnectFromVertices 



Summary 

#lnclude "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgDisconnectFromVertices( pEde ) 

PEDG pEdg; 

Public Function 

Purpose 

The EdgDisconnectFromVertices function unlinks the Edge pEdg to its 
incoming vertex and its outgoing vertex. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Notes 

[pEdg must be linked to a graph.] 

[pEdg must not be linked to any vertices.] 

See Also 

EdgConnectToVertices, EdgGetlnVtx, EdgGetOutVtx, EdgGetVertices 



Edg- 17 



EdgDisconnectFromGrf 

Diagram 



Before 




Unlink pEdg from 
vertices first 



from Graph 
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EdgDisconnectFromGrf 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgDisconnectFromGrf ( pEdg ) 

PEDG pEdg; 

Public Function 

A macro Is available for this function 

Purpose 

The EdgDisconnectFromGrf function unlinks the Edge pEdg from it's Graph. 
The function requires that any linkage to vertices be removed prior to the call. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Notes 

[pEdg must be linked to a graph.] 

[pEdg must not be linked to any vertices.] 

See Also 

EdgConnectToGrf, EdgDisconnectFromVertices 
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Edg Destroy 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgDestroy( pEdg ) 

PEDG pEdg; 

Public Function 

Purpose 

The EdgDestroy function deallocates the memory used by the object and 
deinitiaLizes the Edge object. The Edge pEdg should not be referenced after this 
function call since its memory will have been deallocated. 

Any vertices linked to pEdg will be unlinked and pEdg will also be unlinked 
from its graph. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Notes 

[pEdg must not have a sub-object.] 

See Also 

EdgDelnit, Edglnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgDestroy function. 
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EdgDelnit 

Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgDelnit(pEdg) 
PEDG pEdg; 

Public Function 

Purpose 

The EdgDelnit function deinitializes the Edge object. The EdgDelnit function 
should be the last function called when using the Edge class. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 
Notes 

The first function to call when using the Edge class is Edglnit. 
[pEdg must not already be linked to a graph.] 
[pEdg must not be linked to any vertices.] 

See Also 

EdgDestroy, Edglnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgDelnit function. 
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EdgConnectToVertices 



See Als 

EdgDisconnectFromVertices, EdgGetlnVtx, EdgGetOutVtx, EdgGetVertlces 
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EdgConnectToVertices 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 



Void EdgConnectToVertices( pEdg, pVtxI, pVtxO ) 

PEDG pEdg; 

PVTX pVtxI; 

PVTX pVtxO; 



Public Function 

Purpose 

The EdgConnectToVertices function links the Edge pEdg to the incoming Vertex 
pVtxI and the outgoing Vertex pVtxO. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

pVtxI - Pointer to a structure of type Vertex where this is the 

incoming vertex. An mcoming vertex has the edge as 

an outgoing edge. 

pVtxO - Pointer to a structure of type Vertex where this is the 
outgoing vertex. An outgoing vertex has the edge as an 
incoming edge. 

Return Value 

No return value 
Notes 

[pEdg must be linked to a graph.] 
[The Vertex pVtxI must be linked to a graph.] 
[The Vertex pVtxO must be linked to a graph.] 
[pEdg must not be linked to any vertices.] 
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EdgConnectToGrf 



Diagram 
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EdgConnectToGrf 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void v EdgConnectToGrf( pEdg, pGrf ) 

PEDG 
PGRF 

Public Function 

A macro Is available for this function 

Purpose 

The EdgConnectToGrf function links the Edge pEdg to the Graph pGrf. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 
pGrf - Pointer to the Graph structure that the edge will be 
linked to. 

Return Value 

No return value 

Notes 

[pEdg must not already be linked to a graph.] 
[pEdg must not be linked to any vertices.] 

See Also 

EdgDisconnectFromGrf 



'5> 
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EdgComparelnVtx 

Notes 

The client function should return True for the EdgComparelnVtx function 
return True. 

The optional function will only be called if pEdg is linked to pVtx. 

See Also 

VtxFindOutEdg, VtocFindOutEdgClient 

Diagram 
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EdgComparelnVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Bool EdgCompareInVtx( pEdg, pVtx, offset, pBlk ) 

PEDG pEdg; 
PVTX pVtx; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The EdgComparelnVtx function determines if the Edge pEdg has an incoming 
Vertex pVtx. 

If the caller requires that the comparison should have additional criteria other 
than linkage, an Edge client function can be passed. The function is passed the 
matching edge to determine if this is the edge in question. 

The Block pBlk contains the client function and an optional list of arguments. 
The function must return a boolean (True/False) value. 

The EdgComparelnVtx function is typically used as part of a larger function for 
scanning edges. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

pVtx - Pointer to a structure of type Vertex where this is an 

incoming vertex. An incoming vertex has the edge as 

an outgoing edge. 

offset - The distance in bytes between an Edge and it's client 
pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the EdgComparelnVtx function is True if the incoming 
Vertex pVtx is linked to the Edge pEdg, otherwise False is returned. 
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EdgClear 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgQear( pEdg ) 

PEDG pEdg; 

Public Function 

Purpose 

The EdgClear function unlinks the Edge pEdg from its vertices and also 
unlinks pEdg from its graph. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgClear function. 
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EdgAsOutLel 



Summary 

#lnclude "cobjects.h" 
#include "edgmac.h" 

PLEL EdgAsOutLel(pEdg) 
PEDG pEdg; 

Friend Function 

A macro is available for this function 

Purpose 

The EdgAsInLel function returns a pointer to the outgoing vertex ListElement 
structure contained the Edge pEdg. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgAsInLel function is a pointer to the outgoing 
vertex ListElement structure contained by the Edge pEdg. 

Notes 

This function is used by the Vertex class. 

See Also 

EdgAsGrfLel, EdgAsInLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsOutLel function. 
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EdgAsObj 



Summary 



#include "cobjects.h' 
#include "edgmac.h" 



POBJ 

PEDG 



EdgAsObj(pEdg) 
pEdg; 



Private Function 



Purpose 



The EdgAsObj function returns a pointer to the Object structure contained by 
the Edge pEdg. 



Return Value 

The return value from the EdgAsObj function is a pointer to the Object 
structure contained by the Edge class. 



The Object pointer can be used to send a message to the client of the edge. 

See Also 

EdgAsGrfLel, EdgAsInLel, EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsObj function. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 



Notes 
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EdgAslnLel 



Summary 

#lnclude "cobjects.h' 
#lnclude "edgmac.h" 



PLEL 

PEDG 



EdgAsInLeK pEdg ) 
pEdg; 



Friend Function 

A macro Is available for this function 



Purpose 



The EdgAslnLel function returns a pointer to the incoming vertex ListElement 
structure contained the Edge pEdg. 



Return Value 

The return value from the EdgAslnLel function is a pointer to the incoming 
vertex ListElement structure contained by the Edge pEdg. 

Notes 

This function is used by the Vertex class. 

See Also 

EdgAsGrfLel, EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAslnLel function. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 
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EdgAsGrfLel 



Summary 

#include "cobjects.h' 
#include "edgmac.h" 



PLEL 

PEDG 



EdgAsGrfLeK pEdg ) 
pEdg; 



Friend Function 

A macro Is available for this function 



Purpose 



The EdgAsGrfLel function returns a pointer to the ListElemeni structure that is 
contained within the Edge pEdg. This ListElemeni is used by the List within the 
Graph object. 



Return Value 

The return value from the EdgAsGrfLel function is a pointer to a ListElement 
structure. 



The ListElement pointer returned is contained as part of the Edge pEdg. This 
function is used by the Graph object. 

See Also 

EdgAsInLel. EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsGrfLel function. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 



Notes 
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Class Reference for Edge 



Structure Name: 
Abbreviation: 
Class Type: 



Edge 
Edg 

Inheritable class 
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DpaVisitSelfAndSuccessors 



See Also 

DpaVisit, DpaVisitClient, DpaVisitRange, DpaVisitRegion 

Diagram 
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DpaVisitSelfAndSuccessors 



Summary 

#include "cobjects.h 1 
#include "dpamac.h' 



Mediumlnt 
PBLK 



Void 
PDPA 




Public Function 



Purpose 



The DpaVisitSelfAndSuccessors function walks the DynamicArray pDpa and 
calls a GenericPointer function for each element visited. The array is walked in 
a forward direction (self to last) starting with the element beg. 

The Block pBlk contains the function and an optional list of arguments. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. This is 




function to call and any optional parameters to be sent 
to the function. 



index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 



Return Value 



No return value 



Notes 



The GenericPointer function may return a value but it is ignored. 
[The index beg must be in the range (O-END].] 
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DpaVisitRegion 



Notes 

The GenericPointer function may return a value but it is ignored. 

(The index beg must be in the range [O-END].] 

[(beg + n) must be less than or equal to the size of the array.] 

See Also 

DpaVisit, DpaVisitClient, DpaVisitRange, DpaVisitSelfAndSuccessors 

Diagram 
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DpaVisitRegion 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 



VoW^ Dj>aVisitRegion( pDpa, beg, n, pBlk ) 

Mediumlnt Eeg; 

Mediumlnt n; 

PBLK pBlk; 



Public Function 

Purpose 

The DpaVisitRegion function walks a region of array elements, starting with 
beg for a count of n times, for the DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. 

The Block pBlk contains the function and an optional list of arguments. 

A region of array elements is defined as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse. [O-END] 

n - Number of elements to traverse. (1-SIZE] 

pBlk - Pointer to structure of type Block which contains the 

function to call and any optional parameters to be sent 

to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 
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DpaVisitRange 



Notes 

The GenericPointer function may return a value but it is ignored. 
[The Index beg must be In the range [O-END].] 
[The index end must be in the range [O-END].] 
[beg must be less than or equal to end.] 

See Also 

DpaVisit, DpaVisitClient, DpaVisitRegion, DpaVisitSelfAndSuccessors 

Diagram 
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DpaVisitRange 



Summary 

#include "cobjects.h' 
#lnclude "dpamach* 



» 



Void 
PDPA 



pDpa; 
beg; 
end; 
pBlk; 



DpaVisitRange( pDpa, beg, end, pBlk ) 



Mediumlnt 
Mediumlnt 
PBLK 



Public Function 



Purpose 



The DpaVisitRange function walks a range of array elements, beg through end, 
for the DyncunrxicArray pDpa and calls a GenericPointer function for each 
element visited. The array is walked in a forward direction. 

The Block pBlk contains the function and an optional list of arguments. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



beg 
end 
pBlk 



pDpa 



Pointer to a structure of type DynamicArray. This is 

the array to walk. 

Index to start of traverse. [O-END] 

Index to end of traverse. [O-END] 

Pointer to structure of type Block which contains the 

function to call and any optional parameters to be sent 

to the function. 



index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 



No return value 
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DpaVisitClient 



See Also 

DpaVisitRange, DpaVisitRegion, DpaVisitSelfAndSuccessors 

Diagram 



10 elements 



pDpa 



IPlllllIPIlII 



0 END 
mil all Elements 



B 



Element Visited and Order 



Dpa - 45 



DpaVisitClient 



Summary 

#include "cobjects.h" 
#Include "dpamac.h" 



Void DpaVisitdienK pDpa, offset, pBlk ) 

PDPA pDpa; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The DpaVisitClient function walks the entire DynamicArray pDpa and calls a 
client function for each element visited. The array is walked in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

offset - The distance in bytes between the DynamicArray pDpa 
and it's client pointer. Hie value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The GenericPointer function may return a value but it is ignored. 
If any of the elements of the array are NULL, they are not visited. 
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DpaVisit 



Diagram 
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DpaVisit 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaVisit(pDpa,pBlk) 
PDPA pDpa; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaVisit function walks the entire DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

No return value 

Notes 

The GenericPointer function may return a value but it is ignored. 

See Also 

DpaVisitClient, DpaVisitRange, DpaVisitRegion, DpaVisitSelfAndSuccessors 
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DpaShiftUp 
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DpaShiftUp 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaShiftUp( pDpa, n ) 

PDPA pDpa; 
Mediumlnt n; 

Public Function 

Purpose 

The DpaShiftUp function shifts n elements up in the DynamicArray pDpa. The 
size of the DynamicArray pDpa is unchanged. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
n - Number of elements to scroll up in array. 

Return Value 

No return value 

Notes 

{N must be greater than zero and less than the array size.] 

See Also 

DpaAppend, DpaDelete, DpaExpand, DpaShiftDown 
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DpaShiftDown 



Diagram 
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DpaShiftDown 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaShiftDown( pDpa, n ) 

PDPA pDpa; 
Mediumlnt n; 

Public Function 

Purpose 

The DpaShiftDown function shifts n elements down in the DynamicArray pDpa. 
The size of the DynamicArray pDpa is unchanged. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
n - Number of elements to shift down in array. 

Return Value 

No return value 

Notes 

[N must be greater than zero and less than the aray size.] 

See Also 

DpaAppend, DpaDelete, DpaExpand, DpaShiftUp 
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DpaSetSize 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 

Void DpaSetSize( pDpa, size ) 

PDPA pDpa; 
Mediumlnt size; 

Public Function 

Purpose 

The DpaSetSize function sets the new minimum size of the DynamicArray pDpa 
as a multiple of the increment size. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
size - New size of the dynamic array. 

Return Value 

No return value 

Notes 

If the size of the array is reduced the elements are cut from the end of the 
array. 

If the size of the array is expanded then the additional NULL elements are 
appended to the end of the array. 

[The new size must be greater than or equal to zero.] 

See Also 

DpaGetSize, Dpalnit, DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaSetSize function. 
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DpaSetRegionNull 
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DpaSetRegionNull 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 

Void 



PDFA DpaSetRegionNulK pDpa, beg, n ) 

Mediumlnt Eeg; 



>eg 

Mediumlnt n; 
Public Function 

Purpose 

The DpaSetRegionNull walks a region of elements, starting with beg for a count 
of n times, for the DynamicArray pDpa and assigns a NULL value to each 
element visited. 

A region of array elements is defined as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 

EDpa - Pointer to a structure of type DynamicArray. 
eg - Index to start of traverse. [O-END] 

n - Number of elements to substitute NULL. [1-SIZE] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 

Notes 

[The index beg must be in the range [O-END].] 

[(beg + n) must be less than or equal to the size of the array.] 
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DpaSetNth 

Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaSetNtMpDpa, index, gp) 

PDPA pDpa; 
Mediumlnt index; 
GenericPtr gp; 

Public Function 

Purpose 

The DpaSetNth function assigns the GenericPointer gp to the DynamicArray 
pDpa at the element index. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

index - Index to element in array. 

gp - GenericPointer to be assigned to element. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

No return value 

Notes 

(The index index must be in the range [O-END].] 

See Also 

DpaGetNth, DpaGetLast 
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See Also 

DpaDelnlt, DpaDestroy, DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the I 
Dpalnit function. w 
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Dpalnit 



Summary 

#include "cobjecis.h" 
#lnclude "dpamac.h" 

Void DpaIrdt(pDpa,s,i) 

PDPA pDpa; 

Mediumlnt s; 

Mediumlnt i; 

Public Function 

Purpose 

The Dpalnit function initializes the DynamkArray object. The Dpalnit function 
should be the first function called when using the DynamicArray class. The 
initial size of the array s, and the increment size i for the array are passed. The 
increment size is used for expanding the array as demanded by appends or 
pastes. The memory required by the array's initial size is allocated. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. 
s - Initial size of dynamic pointer array, 

i - Increment size for expansion of array. 

Return Value 

No return value 

Notes 

The last function to call when using the DynamicArray class is DpaDelnit. 

[The increment must be greater than one.] 

[The initial size must be greater than or equal to zero.] 
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DpaGetSize 



Summary 

#lnclude "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaGetSize( pDpa ) 
PDPA pDpa; 

Public Function 

Purpose 

The DpaGetSize function returns the size of the DynamicArray pDpa. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

The return value from the DpaGetSize function is the size of the array. 

See Also 

Dpalnit, DpaNew, DpaSetSize 
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Diagram 
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DpaGetLast 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

GenericPtr DpaGetLasH pDpa ) 
PDPA pDpa; 

Public Function 

Purpose 

The DpaGetLast function returns the GenericPointer contained in the 
DynamicArray pDpa as the last element. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

The return value from the DpaGetLast function is the GenericPointer contained 
in the last array element. 

Notes 

[The array must have at least one element.] 

See Also 

DpaGetNth, DpaSetNth 
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DpaGetNth 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

GenericPtr DpaGetNthC pDpa, n ) 
PDPA pDpa; 
Mediumlnt n; 

Public Function 

Purpose 

The DpaGetNth function returns the GenericPointer contained in the 
DynamicArray pDpa at element index. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
index - Index to array element. [O-END] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaGetNth function is the GenericPointer contained 
in DynamicArray pDpa at element index. 

Notes 

[The index n must be in the range [O-END].] 

See Also 

DpaGetLast, DpaSetNth 
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DpaFindRangeFwd 



Notes 

[The index beg must be in the range [O-END].] 
[The index end must be in the range [O-END].] 
[beg must be less than or equal to end.] 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrBwd, DpaFindPtrFwd, 
DpaFindRangeBwd 
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DpaFindRangeFwd 



Summary 

#lnclude "cobjects.h" 
#include "dpamac.h" 



Mediumlnt DpaFindRangeFwd( pDpa, beg, end, pBlk ) 

PDPA pDpa; 

Mediumlnt beg; 

Mediumlnt end; 

PBLK pBlk; 



Public Function 

Purpose 

The DpaFindRangeFwd function walks a range of array elements, beg through 
end, for the DynamicArray pDpa and calls a GenericPointer function for each 
element visited. The array is walked in a forward direction. The function will 
terminate when the GenericPointer function returns True or the end of the 
range is reached. If a True value is returned, the index of the array element is 
returned. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [O-END] 

end - Index to end of traverse. [O-END] 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaFindRangeFwd function is the index to the first 
array element for which the GenericPointer function returns True. Otherwise -1 
is returned. 
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DpaFindRangeBwd 



Notes 

[The index beg must be in the range (0-ENDJ.) 
[The index end must be in the range [O-END].] 
[beg must be less than or equal to end.] 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrBwd, DpaFindPtrFwd, 
DpaFindRangeFwd 

Diagram 
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DpaFindRangeBwd 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Medmmlnt DpaFindRangeBwd( pDpa, beg, end, pBlk ) 

Mediumlnt beg? 
Mediumlnt end; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaFindRangeBwd function walks a range of array elements, beg through 
end, for the DynamicArray pDpa and calls a GenericPointer function for each 
element visited. The array is walked in a backward direction. The function will 
terminate when the GenericPointer function returns True or the end of the 
range is reached. If a True value is returned, the index of the array element is 
returned. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [O-END] 

end - Index to end of traverse. [O-END] 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaFindRangeBwd function is the index to the first 
array element for which the GenericPointer function returns True. Otherwise -1 
is returned. 
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DpaFindPtrFwd 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 

Mediumlnt DpaFindPtrFwd( pDpa, bee, gp ) 
PDPA pDpa; ^ 5 

Mediumlnt beg: 
GenericPtr gp; 

Public Function 

Purpose 

The DpaFindPtrFwd function walks the DynamicArray pDpa, starting at beg 
and ending at the last element of the array, and returns an index to the 
element for which the GenericPointer gp equals the GenericPointer of the 
element visited. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse, 

gp - GenericPointer to be compared. 

Return Value 

The return value from the DpaFindPtrFwd function is the index of the array 
element for which the GenericPointer of the element equals the GenericPointer 
gp. If no match is found the function returns - 1 . 

Notes 

[The index beg must be in the range [O-ENDJ.] 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrBwd, DpaFindRangeFwd, 
DpaFindRangeBwd 
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DpaFindPtrBwd 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaFindPtrBwd ( pDpa, bee, ep ) 
PDPA pDpa; F F 

Mediumlnt beg; 
GenericPtr gp; 

Public Function 

Purpose 

The DpaFindPtrBwd function walks the DynamicArray pDpa, starting at beg 
and ending at the first element of the array, and returns an index to the 
element for which the GenericPointer gp equals the GenericPointer of the 
element visited. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse, 

gp - GenericPointer to be compared. 

Return Value 

The return value from the DpaFindPtrBwd function is the index of the array 
element for which the GenericPointer of the element equals the GenericPointer 
gp. If no match is found the function returns -1. 

Notes 

[The index beg must be in the range [O-END].] 
See Also 

DpaCount, DpaCountRange, DpaFind. DpaFindPtrFwd, DpaFindRangeFwd, 
DpaFindRangeBwd 
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DpaHnd 



Summary 

#lnclude "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaFind( pDpa, pBlk ) 
PDPA pDpa; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaFind function walks the DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. The function will terminate when the GenericPointer 
function returns True or the end of the array is reached. If a True value is 
returned, the index of the array element is returned. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

The return value from the DpaFind function is the index of the first array 
element for which the GenericPointer function returns True. If no function 
returns True then the return value is -1. 

See Also 

DpaCount, DpaCountRange, DpaFindPtrBwd, DpaFindPtrFwd, 
DpaFindRangeFwd, DpaFindRangeBwd 



Dpa- 15 



DpaExpand 



Notes (cont) 

the caller is required to assign values to the new elements with the DpaSetNth 
function. The DpaAppend function assigns a GenericPointer value to the 
appended array element. 

At least one element will always be moved down the array, 
[beg must be in the range (OrDpaGetSize].] 
[n must be greater than zero.] 

See Also 

DpaAppend, DpaDelete, DpaShiftDown, DpaShiftUp 

Diagram 
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DpaExpand 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaExpand( pDpa, beg, n ) 

PDPA pDpa; 

Mediumlnt beg; 

Mediumlnt n; 

Public Function 

Purpose 

The DpaExpand function expands the DynamicArray pDpa by inserting NULL 
values into a region of array elements starting with beg for a count of n times. 

A region of array elements is defined as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 



EDpa - Pointer to a structure of type DynamicArray. 
eg - Index to beginning of the paste. 10-END] 

n - Number of elements to paste into array. [1-SIZE] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 
Notes 

The size of the array is expanded, if required, to accommodate the additional 
elements. 

This function differs from the DpaAppend function in that 
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Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaDestroy( pDpa ) 

PDPA pDpa; 

Public Function 

Purpose 

The DpaDestroy function deallocates the memory used by the object and 
deinitializes the DynamicArray object. The DynamicArray pDpa should not be 
referenced after this function call since its memory will have been deallocated. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

No return value 
See Also 

DpaDelnit, Dpalnit, DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaDestroy function. 
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Notes (cont) 

[(beg + n) must be less than or equal to the size of the array.] 

See Also 

DpaAppend, DpaExpand, DpaShiftDown, DpaShiftUp 
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DpaDelete 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaDelete( pDpa, be& n ) 

PDPA pDpa; 

Mediumlnt beg; 

Mediumlnt n; 

Public Function 

Purpose 

The DpaDelete function deletes a region of array elements, starting with beg for 
a count of n times, from the DynamicArray pDpa. 

A region of array elements is denned as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 



EDpa - Pointer to a structure of type DynamicArray. 
eg - Index to beginning of the delete. [O-END] 

n - Number of elements to delete from array. [1-SIZE] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 
Notes 

The array size is reduced by the number of elements that are deleted. 
[The index beg must be in the range [O-END].] 
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Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaDeInit( pDpa ) 

PDPA pDpa; 

Public Function 

Purpose 

The DpaDelnit function deinitializes the DynamicArray object. The DpaDelnit 
function should be the last function called when using the DynamicArray class. 
The memory used by the array is deallocated. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

No return value 

Notes 

The first function to call when using the DynamicArray class is Dpalnit. 

See Also 

DpaDestroy, Dpalnit, DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaDelnit function. 
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DpaCount Range 

Notes (cont) 

[The Index beg must be in the range [O-END].] 
[The index end must be in the range [O-END]. 1 
[beg must be less than or equal to end.] 

See Also 

DpaCount, DpaFind. DpaFindRangeFwd, DpaFindRangeBwd 
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DpaCountRange 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaCountRange( pDpa, beg, end, pBlk ) 
PDPA pupa; 
Mediumlnt beg; 
Mediumlnt end; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaCountRange function returns the number of times that a 
GenericPointer function returns a True value. The DynamicArray pDpa is 
walked for a range of elements beg through end in a forward direction with the 
GenericPointer function being called once for each element visited. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [O-END] 

end - Index to end of traverse. [O-END] 

pBlk - Pointer to structure of type Block: which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaCountRange function is the number of times the 
GenericPointer function returns True for a range of array elements. 

Notes 
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DpaCount 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaCountf pDpa, pBlk ) 
PDPA pDpa; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaCount function returns the number of times that a GenericPointer 
function returns a True value. The entire DynamicArray pDpa is walked in a 
forward direction with the GenericPointer function being called once for each 
element visited. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

The return value from the DpaCount function is the number of times the 
GenericPointer function returns True. 

See Also 

DpaCountRange, DpaFind, DpaFindRangeFwd, DpaFindRangeBwd 
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Summary 

#lnclude "cobjects.h' 
#include "dpamach* 



Void 
PDPA 



DpaClear( pDpa ) 
pDpa; 



Public Function 



Purpose 



The DpaClear function sets the array to its initial state and sets the size of the 
array to 0. 

Parameter - Description 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaClear function. 



pDpa 



Pointer to a structure of type DynamicArray. The array 
being cleared. 
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DpaAppend 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaAppend( pDpa, gp ) 
PDPA pDpa; 
GenericPtr gp; 

Public Function 

Purpose 

The DpaAppend function appends the GenericPointer gp to be last in the 
DynamicArray pDpa. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. 
gp - GenericPointer to be appended to the array. 

Return Value 

The return value from the DpaAppend function is the size of the array after the 
GenericPointer gp has been appended. 

Notes 

This function differs from the DpaExpand function in that it assigns a 
GenericPointer to the new array element whereas DpaExpand opens up the 
array and the caller is required to assign values to the new elements with the 
DpaSetNth function. 

The array is expanded if needed. 

See Also 

DpaDelete, DpaExpand, DpaShiftDown, DpaShiftUp 
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Class Reference for DynamicArray 

Structure Name: DynamicArray 
Abbreviation: Dpa 
Class Type: Primitive 
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DIISendDestroy 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 

Void DllSendDestroy( pDll ) 

PDLL pDll; 

Public Function 

Purpose 

The DIISendDestroy function sends a message to the client of the List pDll 
asking it to destroy the List The List client function will receive this message 
and should destroy the list element. This message function should be included 
in the List client message array. 

Return Value 

No return value 



Example 

Please refer to class test procedure TSTDLL.CTSTLEL.C for an example of the 
use of the DIISendDestroy function. 
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Notes (cont) 

pLel must be linked to the list. 
See Also 

DllClear, DllCut, DUCutRange, DllPasteRangeAfter, DllPasteRangeBefore, 
DllPasteRangeFirst 

Diagram 
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DIIPasteRangeLast 



Summary 

#include "cobjects.h' 
#include "dllmac.h" 



Void 
PDLL 
PLEL 
PLEL 



DIIPasteRangeLast pDll, pLelBeg, pLelEnd ) 

pDll; 

pLelBeg; 

pLelEnd; 



Public Function 

A macro Is available for this function 



Purpose 



The DIIPasteRangeLast function links a range of ListElements pLelBeg through 
pLelEnd to the List pDll as the last list elements of the list. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 

modify. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement This is the 

last list element to link to the list. 

Return Value 

No return value 



pLelBeg through pLelEnd cannot currently belong to a list. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd. 

The pLelBeg must have a set of successors one of which is pLelEnd. 



Notes 
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DIIPasteRangeFirst 



Notes (cont) 

pLel must be linked to the list. 

See Also 

DllClear, DllCut, DllCutRange, DllPasteRangeAfter, DllPasteRangeBefore, 
DUPasteRangeLast 

Diagram 

Before After 
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DIIPasteRangeFirst 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DllPasteRangeFirsK pDll, pLelBeg, pLelEnd ) 

PDLL pDll; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

A macro is available for this function 

Purpose 

The DIIPasteRangeFirst function links a range of ListElements pLelBeg through 
pLelEnd to the List pDll as the first list elements of the list. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter • Description 



pDll - Pointer to a structure of type List This is the list to 
modify. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

pLelBeg through pLelEnd cannot currently belong to a list. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd. 

The pLelBeg must have a set of successors one of which is pLelEnd. 
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DIIPasteRangeBefore 



Notes (cont) 

(If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
(pLelBeg must not already be In a list.] 
(pLel must be in the list pDH.] 

See Also 

DllClear, DllCut, DllCutRange, DllPasteRangeAfter, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 



Before After 




Dll - 43 



DIIPasteRangeBefore 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 



Void DllPasteRangeBefore( pDll, pLel, pLelBeg, pLelEnd ) 

PDLL pDU; 

PLEL pLel; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

Purpose 

The DIIPasteRangeBefore function links a range of ListElements pLelBeg 
through pLelEnd to the List pDll as the preceding list elements of the 
ListElement pLel. If the ListElement pLel is NULL then the ListElements pLelBeg 
through pLelEnd are linked to the List pDll as the first elements. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
modify. 

pLel - Pointer to a structure of type ListElement. pLelBeg 
through pLelEnd will be linked as the predecessors of 
this list element. 

pLelBeg - Pointer to a structure of type ListElement This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

The pLelBeg must have a set of successors one of which is pLelEnd. 
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DIIPasteRangeAfter 



Notes (cont) 

(If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.l 
[pLelBeg must not already be in a list.] 
(pLel must be in the list pDll.] 

See Also 

DllClear, DllCut, DllCutRange, DllPasteRangeBefore, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 

Before After 

Paste After 
this Element 
pLel 




JpQpQD Range of Elements 

pLelBeg^^^pLelEnd 
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DIIPasteRangeAfter 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DllPasteRangeAfter( pDll, pLel, pLelBeg, pLelEnd ) 

PDLL pDll; 

PLEL pLel; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

Purpose 

The DIIPasteRangeAfter function links a range of ListElements pLelBeg through 
pLelEnd to the List pDll as the succeeding list elements of the ListElement pLel. 
If the ListElement pLel is NULL then the ListElements pLelBeg through pLelEnd 
are linked to the List pDll as the last elements. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
modify. 

pLel - Pointer to a structure of type ListElement. pLelBeg 
through pLelEnd will be linked as the successors of 
this list element. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

The pLelBeg must have a set of successors one of which is pLelEnd. 
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DIINotifyPasteRange 



Summary 

#include "cobjects.h 1 
#include "dllmac.h" 



Void 
PDLL 
PLEL 
PLEL 




Friend Function 



Purpose 



The DIINotifyPasteRange is called by the ListElement class to notify the List that 
elements were pasted. 

Return Value 

No return value 



This is a function is only to be used by the ListElement class. 

See Also 

DllNotifyCutRange 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for a 
use of the DIINotifyPasteRange function. 



Notes 
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DIINotifyCutRange 



Summary 

#include "cobjects.h' 
#include "dllmac.h" 



Void 
PDLL 
PLEL 
PLEL 



DllNotifyCutRange( pDU, pLelBeg, pLelEnd ) 

pDU; 

pLelBeg; 

pLelEnd; 



Friend Function 



Purpose 



The DIINotifyCutRange is called by the ListElement class to notify the List that 
elements were cut. 

Return Value 

No return value 



This is a function is only to be used by the ListElement class. 

See Also 

DllNotifyPasteRange 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIINotifyCutRange function. 



Notes 
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DIILelClientVisitFwd 



See Also 

DllLelCUentVisitBwd 

Diagram 



Last Element 
to Visit 




Walk all Elements 
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DIILelClientVisitFwd 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DULeiaientVisitFwd( pDll, offset, pBlk ) 

PDLL pDll; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The DIILelClientVisitFwd function walks the entire List pDll and calls a 
ListElement client function for each list element. The list is walked in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 

walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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DIILelClientVisitBwd 



See Also 

DULelCllentVisitFwd 

Diagram 



First Element 
to Visit 




Walk all Elements 
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DIILelClientVisitBwd 



Summary 

#include "cobjccts.h" 
#include "dllmac.h" 



Void DULelQientVisitBwdC pDll, offset, pBlk ) 

PDLL pDll; 

Mediumlnt • offset; 

PBLK pBlk; 



Public Fvinctlon 

Purpose 

The DIILelClientVisitBwd function walks the entire List pDll and calls a 
ListElement client function for each list element. The list is walked in a 
backward direction (last to first). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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DIILelClientLast 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

POBJ DULeiaientLasK pDll, offset ) 

PDLL pDll; 

Public Function 

A macro Is available for this function 

Purpose 

The DIILelClientLast function returns the client pointer of the last ListElement 
in the List pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List 
offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientLast function is a pointer to the client of 
the last list element in the List pDll. If the list is empty the function will return 
NULL. 

See Also 

DllLelClientFlrst 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIILelClientLast function. 



Dll - 33 



DIILelClientGetNth 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIILelClientGetNth function. 
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DIILelClientGetNth 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



POBJ DULeiaientGetNth( pDll, offset, index ) 

PDLL pDU; 

Mediumlnt offset; 

Mediumlnt index; 



Public Function 

Purpose 

The DIILelClientGetNth function returns the client pointer of the Nth 
ListElement in the List pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List 

offset - The distance in bytes between a ListElement and it's 

client pointer. The value must be 0 or negative, 
index - Index to list element in list. [O-END] 



offset: See the Class Data Structures reference guide for details on using 
offsets. 

index: 0 is the first list element index in the list and END is the last 
consecutively numbered list element index. 

Return Value 

The return value from the DIILelClientGetNth function is the client pointer of 
the indexed list element in the List pDll. If the list is empty the function will 
return NULL. 

See Also 

DllGetNth 
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DIILelClientFirst 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

POBJ DllLelClientFirsK pDll, offset) 

PDLL pDll; 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The DIILelClientFirst returns the client pointer of the first ListElement in the 
List pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List 
offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientFirst function is a pointer to the client of 
the first list element in the List pDll. If the list is empty the function will return 
NULL. 

See Also 

DllLelClientLast 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIILelClientFirst function. 
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DIILelClientFind 
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DIILelClientFind 



Summary 

include "cobjects.h" 
#include "dllmac.h" 



POBJ DIILelClientFind* pDll, offset, pBlk ) 

PDLL pDll; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The DIILelClientFind function walks the List pDll and calls a ListElement client 
function for each list element. The list is walked in a forward direction. The 
function terminates when the client function returns True or the end of the list 
is reached. If a True value is returned, the client pointer of the list element is 
returned, otherwise NULL is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/Flase) value. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 

walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientFind function is a pointer to the client of 
the first list element for which the client function returns True. Otherwise 
NULL is returned. 
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DIILelClientCount 
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DIILelClientCount 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 

Mediumlnt DULelQientCountC pDll, offset pBlk ) 
PDLL pDll; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The DIILelClientCount function returns the number of times that a ListElement 
client function returns non-zero. The entire List pDll is walked in a forward 
direction with the client function being called once for each list element visited. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a Mediumlnt value. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
walk. • 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientCount function is the number of times 
the ListElement client function returns non-zero. 
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DlllsEmpty 



Summary 

#include "cobjects.h 1 
#include "dllmac.h" 



Bool 
PDLL 




Public Function 

A macro Is available for this function 



Purpose 

The DlllsEmpty function determines if the List pDll has any elements. 



Return Value 

The return value from the DlllsEmpty is True if the List pDll contains no list 
elements or False if it does. 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DlllsEmpty function. 



Parameter - Description 



pDll 



Pointer to a structure of type List 
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pLel 



1 
1 
1 
1 
1 
1 
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DlllnsertFirst 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DlHnsertFirst(pDll,pLel) 
PDLL pDll; 
PLEL pLel; 

Public Function 

A macro Is available for this function 

Purpose 

The DlllnsertFirst function links the ListElement pLel as the first list element of 
the List pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being 

modified. 

pLel - Pointer to a structure of type ListElement. The list 
element will be the first in the list. 

Return Value 

No return value 

Notes 

pLel cannot already belong to a list. 

See Also 

DllAppend, DllAppendLast, Dlllnsert 
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Dlllnsert 

Diagram 



Before 



After 




Insert before 
this Element 
pLel 
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I 
II 
1 
II 
1 
1 
1 
I 

1 
1 
1 
1 
1 
1 
I 
1 
1 



Dll - 2.2 



Dlllnsert 



Summary 

#inclu<?e "cobjects.h" 
#include "dllmac.h" 



Void DUInsert( pDll, pLel, pLellns ) 

PDLL pDU; 

PLEL pLel; 

PLEL pLellns; 



Public Function 

Purpose 

The Dlllnsert function links the ListElement pLellns, preceding the ListElement 
pLel, to the List pDll. 

If the ListElement pLel is NULL then pLellns is inserted to be first in the List 
pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being 
modified. 

pLel - Pointer to a structure of type ListElement. pLellns will 
be linked as the predecessor to this list element. 

pLellns - Pointer to a structure of type ListElement. This is the 
list element to link to the list. 

Return Value 

No return value 

Notes 

pLellns cannot already belong to a list. 

pLel, if not NULL, must already be linked to pDll. 

See Also 

DllAppend, DllAppendLast, DllInsertFirst 
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Dlllnit 



Summary 

#include "cobjects.h 1 
#include "dllmac.h" 



Void 
PDLL 



DMnitf pDll ) 
pDll; 



Public Function 



Purpose 



The Dlllnit function initializes the List object. The Dlllnit function should be the 
first function called when using the List class. 

Parameter - Description 



Return Value 

No return value 
Notes 

The last function to call when using the List class is DUDelnit. 

See Also 

DllDelnit. DllDestroy 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the Dlllnit function. 



pDll 



Pointer to a structure of type List. 
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DIIGetSize 



Summary 

#include "cobjects.h" 
#Include "dllmac.h" 

Mediumlnt DllGetSize( pDU ) 
PDLL pDll; 

Public Function 

Purpose 

The DIIGetSize function returns the number of list elements in the List pDll. 

Parameter - Description 

pDll - Pointer to a structure of type List 

Return Value 

The return value from the DIIGetSize function is the the number of list 
elements in the List pDll. 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetSize function. 
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DIIGetNth 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

PLEL DUGetNth( pDll, index ) 

PDLL pDll; 
Mediumlnt Index; 

Private Function 

Purpose 

The DIIGetNth function returns a pointer to the Nth ListElement in the List 
pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List. 
index - Index to list element in list. [O-END] 

index: 0 is the first list element index in the list and END is the last 
consecutively numbered list element index. 

Return Value 

The return value from the DIIGetNth function is a pointer to a structure of type 
ListElement. The list element is the indexed member of the list. 

See Also 

DllGetFirst, DllGetLast 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetNth function. 
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DIIGetLast 



Summary 

#include "cobjects.h' 
#lnclude "dllmac.h" 



PLEL 
PDLL 



DUGetLasK pDll ) 
pDll; 



Private Function 

A macro Is available for this function 



Purpose 

The DIIGetLast function returns a pointer to the last ListElement in the List 
pDll or NULL if it is empty. 



Return Value 

The return value from the DIIGetLast function is a pointer to a structure of type 
ListElement. The list element is the last list element in the List pDll or NULL if 
the list is empty. 

See Also 

DllGetFirst, DllGetNth 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetLast function. 



Parameter - Description 



pDll 



Pointer to a structure of type List 
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DIIGetFirst 



Summary 

#include "cobjects.h' 
#include "dllmac.h" 



PLEL 
PDLL 




Private Function 

A macro Is available for this function 



Purpose 



The DIIGetFirst function returns a pointer to the first ListElement in the List 
pDll or NULL if it is empty. 



Return Value 

The return value from the DIIGetFirst function is a pointer to a structure of 
type ListElement. The list element is the first in the List pDll or NULL if the list 
is empty. 

See Also 

DllGetLast, DllGetNth 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetFirst function. 



Parameter - Description 



pDll 



Pointer to a structure of type List 
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DIIGetClient 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 

POBJ DllGetClient(pDll, offset) 

PDLL pDll; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The DIIGetClient function returns the client pointer of the List pDll. 

Parameter - Description 

pDll - Pointer to a structure of type List. 

offset - The distance in bytes between the List pDU and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIIGetClient function is the client pointer of the List 
pDll. 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetClient function. 
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DIIDestroy 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DllDestroy( pDU ) 

PDLL pDll; 

Public Function 

Purpose 

The DIIDestroy function deallocates the memory used by the object and 
delnitializes the List object. The List pDll should not be referenced after this 
function call since its memory will have been deallocated. 

Any elements in the list will be unlinked before destroying the object. 

Parameter - Description 

pDll - Pointer to a structure of type List 

Return Value 

No return value 

Notes 

(pDll must not have a sub-object.) 
See Also 

DllDelnit, Dlllnit 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIDestroy function. 
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DIIDelnit 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DUDelniK pDU ) 

PDLL pDll; 

Public Function 

Purpose 

The DIIDelnit function deinitializes the List object. The DIIDelnit function 
should be the last function called when using the List class. 

Parameter - Description 

pDU - Pointer to a structure of type List 

Return Value 

No return value 

Notes 

The first function to call when using the List class is Dlllnit. 
IpDll cannot have any list elements.] 

See Also 

DllDestroy, Dlllnit, DllClear 
Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIDelnit function. 
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DIICutRange 



See Also 

DllClear, DllCut, DllPasteRangeAfter, DllPasteRangeBefore, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 



Before After 
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DIICutRange 



Summary 

#lnclude "cobjects.h' 
#include "dllmac.h" 



Void 
PDLL 
PLEL 
PLEL 



DllCutRange( pDll, pLelBeg, pLelEnd ) 

pDll; 

pLelBeg; 

pLelEnd; 



Public Function 



Purpose 



The DIICutRange function unlinks a range of ListElemenis pLelBeg through 
pLelEnd from the List pDll. The list element preceding pLelBeg will be linked to 
the successor list element of pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list being 

cut. 

pLelBeg - Pointer to a structure of type ListElement This is the 

beginning list element to cut. 
pLelEnd - Pointer to a structure of type ListElement This is the 

ending list element to cut. 

Return Value 

No return value 



The list elements that are cut remain linked but do not belong to any list. All 
elements (inclusive) between pLelBeg and pLelEnd are unlinked from pDll. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.J 

[pLelBeg must be in the list pDll.] 



Notes 
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DllCutChildren 



Summary 

#include "cobjects.h" 
#include "dllmach" 

Void DllCutChildren( pDU ) 

PDLL pDll; 

Public Function 

Purpose 

The DllCutChildren function cuts all list elements (if any) from the List pDll. 
The list will be in the same state as it was after being initialized. 

Parameter - Description 

pDll - Pointer to a structure of type List The list being 
cleared. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DllCutChildren function. 
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DMCut 



Diagram 
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DllCut 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 

Void DllCut(pDll,pLel) 
PDLL pDU; 
PLEL pLel; 

Public Function 

Purpose 

The DllCut function unlinks the ListElement pLel from from the List pDll. 

Parameter - Description 

pDll - Pointer to a structure of type List This is the list being 
modified. 

pLel - Pointer to a structure of type ListElement. This is the 
list element to cut. 

Return Value 

No return value 

Notes 

[pLel must be in the list pDll.) 
See Also 

DllClear, DllCutRange, DllPasteRangeAfter, DllPasteRangeBefore, 
DllPasteRangeFirst, DllPasteRangeLast 
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DllClear 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 

Void DllClear( pDU ) 

PDLL pDll; 

Public Function 

Purpose 

The DllClear function cuts all list elements (if any) from the List pDll. The list 
will be in the same state as it was after being initialized. 

Parameter - Description 

pDll - Pointer to a structure of type List 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DllClear function. 
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DIIAsObj 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 

POBJ DllAsObi(pDll) 
PDLL pDll; 

Private Function 

A macro Is available for this function 

Purpose 

The DIIAsObj function returns a pointer to the Object structure contained by 
the List pDll. 

Parameter - Description 

pDll - Pointer to a structure of type List 
Return Value 

The return value from the DIIAsObj function is a pointer to the Object structure 
contained by the List class. 

Notes 

The Object pointer can be used to send a message to the client of the List 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIAsObj function. 
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Dll Append Last 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DllAppendLast( pDll, pLel ) 

PDLL pDll; 
PLEL pLel; 

Public Function 

A macro Is available for this function 

Purpose 

The DllAppendLast function links the ListElement pLel to the List pDll as the 
last list element. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being linked 

to. 

pLel - Pointer to a structure of type ListElement. The list 
element will be linked as the last list element. 

Return Value 

No return value 

Notes 

pLel cannot already belong to a list. 

See Also 

DllAppend, Dlllnsert. DUInsertFirst 
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DIIAppend 



Diagram 



Before 



After 




Append After 
this Element 
pLel 



3> 



Element to Append 
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DIIAppend 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 



Void DllAppend( pDll, pLel, pLelApp ) 

PDLL pDll; 

PLEL pLel; 

PLEL pLelApp; 



Public Function 

Purpose 

The DIIAppend function links the ListElemeni pLelApp, succeeding the 
ListElement pLel, to the List pDll. If the ListElement pLel is NULL then pLelApp 
is linked to the List pDll as the last list element. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being linked 

to. 

pLel - Pointer to a structure of type ListElement. pLelApp will 

be linked as the successor of this list element. 

pLelApp - Pointer to a structure of type ListElement. This is the 
list element to link to the list. 

Return Value 

No return value 
Notes 

pLelApp cannot already belong to a list. pLel must already be linked to pDll. 
See Also 

DllAppendLast, Dlllnsert, DllInsertFirst 
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Structure Name: 
Abbreviation: 
Class Type: 



List 
Dii 

Inheritable class 
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CIsSendObjectMessageReturnPtr 



Notes (cont) 

a subobject or superobject of pObj may be the ultimate receiver of the message. 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsSendMessage, ClsSendMessageRetPtr 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsSendObjectMessageReturnPtr function. 
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CIsSendObjectMessageReturnPtr 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 



Void QsSendOb jectMessageReturnPtrt pCls, pObj, m, pBlk ) 

PCLS pCls; 

POBJ pObj; 

Mediumlnt m; 

PBLK pBlk; 



Public Function 

Purpose 

The ClsSendObjectMessageRetPtr function sends the message indicated by the 
selector Index m to the Object pObj which is an object of Class pCls. 
Parameters are sent to the method through the Block pBlk. The return value is 
the return value from the method called. 



Parameter - Description 



pCls - Pointer to a structure of type Class. 

pObj - Pointer to a structure of type Object The object 

receiving the message, 
m - The selector index. 

pBlk - Pointer to a structure of type Block. Optional 
parameters to pass to the method. 



range: m must be in the range [0:N-1] where N is the number of messages pCls 
responds to. 

Return Value 

No return value 

Notes 

If pBlk has a method set it is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. pObj is 
offset by an amount determined by the message first. Therefore, 
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CIsSendObjectMessageReturnlnt 



Notes (cont) 

pObj is offset by an amount determined by the message first. Therefore, a 
subobject or superobject of pObj may be the ultimate receiver of the message. 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsSendMessage, ClsSendMessageRetPtr 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsSendObjectMessageReturnlnt function. 
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CIsSendObjectMessageReturnlnt 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 



Mediumlnt QsSendObjectMessageReturnInt( pCls, pObj, m, pBlk ) 

PCLS pCls; 

POBJ pObj; 

Mediumlnt m; 

PBLK pBlk; 



Public Function 

Purpose 

The ClsSendObjectMessageRetlnt function sends the message indicated by the 
selector index m to the Object pObj which is an object of Class pCls. 
Parameters are sent to the method through the Block pBlk. The return value is 
the return value from the method called. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 

pObj - Pointer to a structure of type Object The object 

receiving the message, 
m - The selector index. 

pBlk - Pointer to a structure of type Block. Optional 
parameters to pass to the method. 



range: m must be in the range [0:N-1] where N is the number of messages pCls 
responds to. 

Return Value 

The return value from the ClsSendObjectMessageRetlnt function is the return 
value from the method which is called. 

Notes 

If pBlk has a method set it is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. 
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CIsSendObjectMessage 



Notes (cont) 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsSendMessageRetlnt, ClsSendMessageRetPtr 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsSendObjectMessage function. 
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CIsSendObjectMessage 



Summary 

#include "cobjects.h" 
#include "clsmach" 



Void ClsSendOb jectMessage( pQs, pObj, m, pBlk ) 

PCLS pCls; 

POBJ pObj; 

Mediumlnt m; 

PBLK pBlk; 



Public Function 

Purpose 

The CIsSendObjectMessage function sends the message indicated by the 
selector index m to the Object pObi which is an object of Class pCls. 
Parameters are sent to the method through the Block pBlk. 



Parameter - Description 



pCls - Pointer to a structure of type Class. 

pObj - Pointer to a structure of type Object The object 

receiving the message, 
m - The selector index. 

pBlk - Pointer to a structure of type Block. Optional 
parameters to pass to the method. 



range: m must be in the range [0:N-1] where N is the number of messages pCls 
responds to. 

Return Value 

No return value 

Notes 

If pBlk has a method set it is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. pObj is 
offset by an amount determined by the message first. Therefore, a subobject or 
superobject of pObj may be the ultimate receiver of the message. 
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ClsSend Destroy 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Void ClsSendDestroy( pQs ) 

PCLS pCls; 

Public Function 

Purpose 

The ClsSendMessage destroys the Class pCls with the proper Class destructor 
function. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

No return value 

See Also 

ClsDestroy, ClsDelnit, MclSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsSendDestroy function. 
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ClsPrint 



Summary 

#include '^objects.h" 
#include "dsmach" 



Void ClsPrinH pCls, pCio, item, level, name ) 

PCLS pCls; 

PCIO pCio; 

Mediumlnt item; 

Mediumlnt level; 

PSTR name; 



Public Function 

Purpose 

The ClsPrint function prints the contents of the Class pCls on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



pCls - Pointer to a structure of type Class. The Class being 
searched. 

pCio - Pointer to a structure of type ConsolelnputOutput. 
item - The array element number of this instance (or -1). 

level - The level of indentation to print this object with, 
name - The name of this instance. 



Return Value 

No return value 



Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsPrint function. 
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CIslsRoot 



Summary 

#lnclude "cobjects.h" 
#include "clsmac.h" 

Bool ClsIsRooK pQs ) 

PCLS pCls; 

Public Function 

Purpose 

The CIslsRoot function returns True if the Class pCls is the root subclass, 
otherwise False is returned. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIslsRoot function is True if pCls is the root 
subclass otherwise False is returned. 

Notes 

A root subclass is a class which has no subclasses. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIslsRoot function. 
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Clslnit 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



Void 

PCLS 

PMCL 



ClsIniK pCls, pMcl ) 

pCls; 

pMcl; 



Public Function 



Purpose 

The Clslnit function initializes the Class pCls. 

Parameter - Description 



pCls 



Pointer to a structure of type Class. 



Return Value 

No return value 
Notes 

If you create a Class with the MclSendCreateClass function, you do not need to 
call Clslnit as it is called for you. However, if pCls points to statically allocated 
memory, you must call Clslnit before attempting to use any other Class 
functions. When you are done with pCls, you should deinitialize it with 
ClsDelnit. 

See Also 

ClsDelnit, ClsDestroy, MclSendCreateClass, MclSendDestroyClass 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
Clslnit function. 
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CIsGetSuperClasslndex 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumint ClsGetSuperClassIndex( pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSuperClasslndex function returns the index of the superclass pCls. 
If the Class pCls is not a superclass, it returns - 1 . 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIsGetSuperClasslndex function is the index of the 
superclass pCls. If pCls is not a superclass -1 is returned. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSuperClasslndex function. 



CIS -29 



CIsGetSuperClassCount 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetSuperClassCounH pCls ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSuperClassCount function returns the number of superclasses in 
the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIsGetSuperClassCount function is the number of 
superclasses in pCls. 

Notes 

The range of the return value is [0:30]. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSuperClassCount function. 
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CIsGetSubObjectOffset 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt CIsGetSubObjectOffset pOs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSubObjectOffset function returns the offset in bytes of an object of 
Class pCls from its subclass. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetSubObjectOffset function is the offset in bytes 
from an object of pCls to an object of the subclass of pCls. 

Notes 

The return value is in the range {-2000:0]. 

See Also 

ClsGetRootSubObjectOffset 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSubObjectOffset function. 
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CIsGetSubClass 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



PCLS 
PCLS 



ClsGetSubClass( pQs ) 
pCls; 



Public Function 

Purpose 

The CIsGetSubClass function returns the subclass of the Class pCls or NULL if 
the Class pCls has no subclass. 



Return Value 

The return value from the CIsGetSubClass function is a pointer to a structure 
of type Class which is the subclass of pCls. If pCls has no subclass, NULL is 
returned. 

Notes 

If NULL is returned, then pCls is the root Class. 

See Also 

ClsGetRpotSubClass, ClsGetNthSuperClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSubClass function. 



Parameter - Description 



pCls 



Pointer to a structure of type Class. 
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CIsGetSize 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetSize( pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSize function returns the size of the Class pCls in bytes. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIsGetSize function is the size of the Class pCls in 
bytes. 

Notes 

Typically, the size of a class is sizeoff Class ), however you can create classes 
which have larger sizes (for holding class specific data). See the section on 
MetaClass for further details. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSize function. 
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CIsGetRootSubObjectSize 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetRootSubObjectSize( pCls ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetRootSubObjectSize function returns the size in bytes of a root object 
described by the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetRootSubObjectSize function is the size of a 
root object of pCls in bytes. 

Notes 

The root Object is an instance of the root Class which is the subclass of pCls 
which has no subclass. 

See Also 

ClsGetObjectSize, ClsGetRootSubClass, ClsGetRootSubObjectOffset 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetRootSubObjectSize function. 
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CIsGetRootSubObjectOffset 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt QsGetRootSubObjectOffseK pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetRootSubObjectOffset function returns the offset in bytes of the root 
object described by the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetRootSubObjectOffset function is the offset of a 
root object of Class pCls in bytes. 

Notes 

The root Object is an instance of the root Class which is the subclass of pCls 
which has no subclass. 

The return value is in the range [-2000:0]. 

See Also 

ClsGetObjectSize, ClsGetRootSubClass, ClsGetRootSubObjectSize 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetRootSubObjectOffset function. 
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CIsGetRootSubClass 



Summary 

#include "cobjects.h 1 
#include "clsmac.h" 



PCLS 

PCLS 



ClsGetRootSubClass( pQs ) 
pCls; 



Public Function 



Purpose 



The CIsGetRootSubClass function returns a pointer to a structure of type Class 
which is the outermost subclass of the Class pCls. 



Return Value 

The return value from the CIsGetRootSubClass function is a pointer to a 
structure of type Class which is the outermost subclass of the Class pCls. 



By definition, the returned Class cannot have a subclass. 
The root subclass of the returned value is itself. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetRootSubClass function. 



Parameter - Description 



pCls 



Pointer to a structure of type Class. 



Notes 
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CIsGetOffsetOfNthSuper 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetOffsetOfNthSuper function. 
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CIsGetOffsetOfNthSuper 



Summary 

#inolude "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetOffsetOfNthSuper( pCls, n ) 
PCLS pCls; 
Mediumlnt n; 

Public Function 

Purpose 

The CIsGetOffsetOfNthSuper function returns the offset of the object (relative to 
an object of the Class pCls) which is the Nth superclass of pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
n - The index of the superclass. 

range: n must be in the range [0:N-1] where N is the number of superclasses of 
pCls. 

Return Value 

The return value from the CIsGetOffsetOfNthSuper function is the offset from 
an Object of Class pCls needed to get to the Nth superclass. 

Notes 

The return value will be in the range {0:2000]. 

(The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 

See Also 

ClsGetNthSuperClass 
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CIsGetOffsetForMsg 

See Also 

ClsGetMethodAndOffset, ClsGetNthMsg 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetOffsetForMsg function. 
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CIsGetOffsetForMsg 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetOf f setForMsg( pCls, m ) 
PCLS pCls; 
Mediumlnt m; 

Public Function 

Purpose 

The CIsGetOffsetForMsg function returns the offset of the object (relative to an 
object of the Class pCls) which ultimately responds to the message index m. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 
m - The index of the message selector. 

range: m must be in the range [0:N-1] where N is the number of messages to 
which pCls can respond to. 

Return Value 

The return value from the CIsGetOffsetForMsg function is the offset of the 
object which ultimately handles the message m. 



The return value will be in the range [-2000:+2000]. A negative value indicates 
the message is being overridden by a subclass. A positive value means a 
superclass function is being inherited. A value of 0 means pCls is 



[The message number must be greater than or equal to zero, and less than the 
number of messages.] 



Notes 
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CIsGetObjectSize 



Summary 

#lnclude "cobjects.h" 
#include "clsmac.h" 

Mediumlnt ClsGetObjectSize( pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetObjectSize function returns the size in bytes of an (super) object 
described by the (super) Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetObjectSize function is the size of an object of 
this class in bytes. 

Notes 

To get the size of the entire (root) object, not just the superobject, use the 
function ClsGetRootObjectSize. 

See Also 

ClsGetRootObjectSize 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use Of the 
CIsGetObjectSize function. 
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CIsGetNthSuperClass 



Summary 

#lnclude "cobjects.h" 
#include "clsmac.h" 

PCLS asGetNthSuperaass( pCls, n ) 

PCLS pCls; 
Mediumlnt n; 

Public Function 

Purpose 

The CIsGetNthSuperClass function returns a pointer to a structure of type 
Class which is the nth superclass of the Class pCls. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 
n - The index of the superclass. 

range: n must be in the range [0:N-1] where N is the number of superclasses of 
pCls. 

Return Value 

The return value from the CIsGetNthSuperClass function is a pointer to a 
structure of type Class which is the Nth superclass of pCls. 

Notes 

[The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 



Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetNthSuperClass function. 
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CIsGetNthMsg 



Summary 

#lnclude "cobjects.h" 
#lnclude "clsmac.h" 

PMSG QsGetNthMsg( pOs, n ) 

PCLS pCls; 
Mediumlnt n; 

Public Function 

Purpose 

The CIsGetNthMsg function returns a pointer to a structure of type Message 
given the index m for the Class pCls. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 
m - The index of the message 

range: m must be in the range [0:N-1] where N is the number of messages pCls 
responds to. 

Return Value 

The return value from the CIsGetNthMsg function is a pointer to a structure of 
type Message which is the Nth message of pCls. 

Notes 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsGetMethodAndOffset 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetNthMsg function. 
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ClsGetName 



Summary 

#include "cobjects.h 
#include "clsmac.h" 



PSTR 
PCLS 



ClsGetName( pQs ) 
pCls; 



Public Function 



Purpose 

The ClsGetName function returns a pointer to a String containing the name of 
the Class pCls. 

Parameter - Description 



pCls 



Pointer to a structure of type Class. 



Return Value 

The return value from the ClsGetName function is a pointer to a String 
containing the name of the Class pCls. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsGetName function. 
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CIsGetMethodAndOffset 



Notes (cont) 

ppMth will point to a function after this call. 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsGetNthMessage 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetMethodAndOffset function. 
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CIsGetMethodAndOffset 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 



Void asGetMethodAndOffset( pQs, m, ppMth, pOffset ) 

PCLS pCls; 

Mediumlnt m; 

PMTH *ppMth: 

Mediumlnt *pOffset; 



Public Function 

Purpose 

The CIsGetMethodAndOffset function returns a pointer to the Method and the 
offset of the object (relative to this class) which owns the method. The Method 
pointer is returned in ppMth and the offset is returned in pOffset. The method 
and offset are determined by the message index m within the Class pCls. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 
m - The index of the message selector. 

ppMth - Pointer to a pointer to a Method function. The method 
is returned here. 

pOffset - Pointer to a Mediumlnt. The offset is returned here. 



range: *pOffset will be in the range (-2000: +20001. A negative value indicates 
the message is being overridden by a subclass. A positive value means a 
superclass function is being inherited. A value of 0 means pCls is 
defining/overriding the method. 

Return Value 

No return value 
Notes 

m must be in the range [0:N-1] where N is the number of messages to which 
pCls can respond to. 
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CIsGetMessageCount 



Summary 

#lnclude "cobjects.h" 
#include "clsmac.h" 

Mediumlnt CIsGetMessageCount pOs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetMessageCount function returns the number of messages the Class 
pCls can respond to. 

Parameter - Description 

PCls - Pointer to a structure of type Class. 

Range: The range of the return value is [0:SHRT_MAX] where SHRT MAX is 
defined in the include file <limits.h>. 

Return Value 

The return value from the function CIsGetMessageCount function is the 
number of messages pCls responds to. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetMessageCount function. 
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CIsFindSuperClass 



Summary 

#include "cobjects.h' 
#Inelude "clsmac.h" 



PCLS 
PCLS 
PSTR 



QsFindSuperQassC pds, pStr ) 

pCls; 

pStr; 



Public Function 

Purpose 

The CIsFindSuperClass function finds searches the Class pCls for the 
superclass identified by the string pStr and returns a pointer to the superclass 
if found and NULL if not found. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 

pStr - Pointer to a String containing the superclass name. 

Return Value 

The return value from the function CIsFindSuperClass is a pointer to a 
structure of type Class which is the superclass identified by pStr. NULL is 
returned if it is not found. 

Notes 

The search is case-sensitive. 

Superclass names should generally by named the same as the structure that 
they describe. 



Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindSuperClass function. 



Example 
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CIsFindSelectorlndex 

See Also 

CIsFindSelectorlndex, ClsSendObjectMessage 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindSelectorlndex function. 
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CIsFindSelectorlndex 



Summary 

#include "cobjects.h" 
#lnclude "clsmac.h" 

Mediumlnt asFindSelectorIndex( pCls, pStr ) 
PCLS pCls; 
PSTR pStr; 

Public Function 

Purpose 

The CIsFindSelectorlndex function searches the Class pCls for the message 
selector string pStr and returns the index of the selector if found and -1 if not 
found. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 

pStr - Pointer to a String containing the selector name. 

range: The return value will be in the range [0:N-1] where N is the number of 
messages pCls responds to. 

Return Value 

The return value from the CIsFindSelectorlndex function is the index of the 
message if found and -1 if not found. 

Notes 

The search is case-sensitive. 

Selector strings should generally by mixed case without spaces and with the 
first character lowercase. 

The return value can subsequently be used in the ClsSendObjectMessage 
function to send a message to an object. 
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CIsFindMsg 



Summary 

#include "cobjects.h' 
#lnclude "clsmac.h" 



ti 



PMSG 

PCLS 

PSTR 



C3sFindMsg( pCls, pStr ) 

pCls; 

pStr; 



Public Function 

Purpose 

The CIsFindMsg function finds searches the Class pCls for the message 
selector pStr and returns a pointer to the Message if found or NULL if not 
found. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

pStr - Pointer to a String containing the selector name. 

Return Value 

The return value from the CIsFindMsg function is a pointer to a structure of 
type Message which contains the message selector pStr. NULL is returned if it 
is not found. 

Notes 

The search is case-sensitive. 

Selector strings should generally by mixed case without spaces and with the 
first character lowercase. 

See Also 

ClsFindSelectorlndex 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindMsg function. 
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1 

CIsDestroyObject 1 
Example j| 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsDestroyObject function. I 

1 
1 
1 
I 
1 
1 
I 

1 
1 

1 

1 

1 
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CIs Destroy Object 



Summary 

#includc "cobjects.h' 
#lnclude "clsmac.h" 



Void 

PCLS 

POBJ 



CIsDestroyObjecH pCls, pObj ) 

pCls; 

pObj; 



Public Function 

Purpose 

The ClsDestrovObject function deallocates the memory associated with the 
Object pObj whose type is specified by the Class pCls. 



Return Value 

No return value 

Notes 

pObj must have been deinitialized prior to calling this function. 
pCls must be a root class, i.e. it has no subclasses. 
pObj must have been allocated by ClsCreateObject. 
[The class must not have any sub-classes.] 

See Also 

ClsCreateObject 



Parameter - Description 



pCls 
pObj 



Pointer to a structure of type Class. 
Pointer to a structure of type Object. 
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CIsDestroy 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Void asDcstroy( pCls ) 

PCLS pCls; 

Public Function 

Purpose 

The CIsDestroy function deinitializes the Class pCls and deallocates the 
memory used by it. The Class pCls should not be referenced after this function 
is called. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

No return value 

Notes 

Any superclasses owned by pCls are destroyed as well. 
Any messages owned by pCls are destroyed as well. 

pCls should point to a Class which was created by MclSendCreateClass. If pCls 
points to statically allocated memory then the caller should use ClsDelnit 
instead of this function. 

See Also 

ClsDelnit, Clslnit, MclSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsDestroy function. 
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CIsDelnit 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Void ClsDeInit( pQs ) 

PCLS pCls; 

Public Function 

Purpose 

The CIsDelnit function deinitializes the Class pCls. The CIsDelnit function 
should be the last function called when done using pCls and just prior to 
freeing its memory. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

No return value 
Notes 

If you use MclSendCreateClass to create a Class and ClsDestroy to get rid of it 
you will never need to use this function. It is of value only if pCls points to a 
statically allocated structure which was initialized with Clslnit. 

See Also 

ClsDestroy, Clslnit, MclSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsDelnit function. 
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ClsCreateObject 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

POBJ asCrcateObject( pds ) 

PCLS pCls; 

Public Function 

Purpose 

The ClsCreateObject function creates a new Object of the type specified by the 
Class pCls. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the ClsCreateObject function is a pointer to a structure 
of type Object and is the new object instance. 

Notes 

The pointer returned by ClsCreateObject actually is a pointer to two types of 
structure. It is a pointer to the type which is described by the Class pCls and it 
is a pointer to type Object. The reason for this is that all structures which 
either inherit or are inherited from are defined as having their first structure 
member be a structure of type Object In this way, the two structures are 
superimposed upon one another. 

[The class must not have any sub-classes.] 



Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsCreateObject function. 
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Class Reference for Class 



Structure Name: Class 

Abbreviation: CIs 

Class Type: Primitive Class 



BlkSetMethod 



Summary 

#include "cobjects.h 1 
#include "blkmac.h" 



Void 

PBLK 

PMTH 



BlkSetMethod( pBlk, pMth ) 

pBlk; 

pMth; 



Public Function 



Purpose 



The BlkSetMethod function saves the pointer to Method pMth as the function 
to call when executing the Block pBlk. 

Parameter - Description 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkSetMethod function. 



pBlk 
pMth 



Pointer to a structure of type Block. 
Pointer to a Method. 
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BlkPushMediumlnt 



Summary 

#lnclude "cobjects.h" 
#include "blkmac.h" 

Void BlkPushMediumInt( pBlk, p ) 

PBLK pBlk; 
Mediumlnt p; 

Public Function 

Purpose 

The BlkPushMediumlnt function pushes the value p onto the parameter Block 
pBlk. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
p - The integer parameter being pushed. 

Return Value 

No return value 

Notes 

[The total number of parameters must not be larger than the parameter array.] 
Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkPushMediumlnt function. 
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BlkPushLargelnt 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Void BlkPushLargelnK pBlk, p ) 

PBLK pBlk; 
Largelnt p; 

Public Function 

Purpose 

The BlkPushLargelnt function pushes the value p onto the parameter Block 
pBlk. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
p - The integer parameter being pushed. 

Return Value 

No return value 
Notes 

IThe total number of parameters must not be larger than the parameter array.] 

Example 

Please refer to class test procedure TSTBLKC for an example of the use of the 
BlkPushLargelnt function. 
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BlkPushFuncPtr 



Summary 

#include "cobjects.h' 
#include "blkmac.h" 



Void 

PBLK 

PMTH 



BlkPushFuncPtr( pBlk, p ) 
pBlk; 

p; 



Public Function 



Purpose 



The BlkPushFuncPtr function pushes the function pointer Method p onto the 
Block pBlk. 

Parameter - Description 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkPushFuncPtr function. 



pBlk 
P 



Pointer to a structure of type Block. 

Pointer to Method. The pointer parameter being 

pushed. 



Blk- 13 



BlkPushDataPtr 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Void BlkPushDataPtr( pBlk, p ) 

PBLK pBlk; 
PMEM p; 

Public Function 

Purpose 

The BlkPushDataPtr function pushes the data pointer Memory p onto the Block 
pBlk. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 

p - Pointer to Mem. The pointer parameter being pushed. 

Return Value 

No return value 
Notes 

(The total number of parameters must not be larger than the parameter array.] 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkPushDataPtr function. 
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BlkPrint 



Summary 

#include "cobjects.h 
#lnclude "blkmac.h" 



Void 

PBLK 

PCIO 



pBlk; 
pCio; 
item; 
level; 
name; 



BlkPrinK pBlk, pCio, item, level, name ) 



Mediumlnt 
Mediumlnt 
PSTR 



Public Function 

Purpose 

The BlkPrint function prints the contents of the Block pBlk on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array element number of this instance (or -1). 

level - The level of indentation to print this object with, 

name - The name of this instance. 

Return Value 

No return value 



Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkPrint function. 



Example 
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Blklnit 



Summary 

#include "cobjects.h' 
#lnclude "blkmac.h" 



Void 

PBLK 

PMTH 



BlklniK pBlk, pMth ) 

pBlk; 

pMth; 



Public Function 

Purpose 

The Blklnit function initializes the Block pBlk and sets its method to the 
Method pointer pMth. This should be the first function called after pBlk has 
been allocated. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
pMth - Pointer to a Method. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
Blklnit function. 
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BlkHasMethod 



Summary 

#lnclude "cobjects.h" 
#include "blkmac.h" 

Bool BlkHasM ethod( pBlk ) 

PBLK pBlk; 

Public Function 

Purpose 

The BlkHasMethod function returns True if the Block pBlk has a non-NULL 
Method pointer associated with it, otherwise False is returned. 

Parameter - Description 

♦ 

pBlk - Pointer to a structure of type Block. 

Return Value 

The return value from the BlkHasMethod function is True if pBlk has a non- 
NULL value and False if it is NULL. 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkHasMethod function. 
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BlkExecuteRetlnt 



Summary 

#include "cobjects.h" 
#lnclude "blkmac.h" 

Mediumlnt BlkExecuteRetInt( pBlk, pObj ) 
PBLK pBlk; 
POBJ pObj; 

Public Function 

Purpose 

The BlkExecuteRetlnt function executes the method in the Block pBlk and 
passes parameters to it. The first parameter passed will be the Object pObj. The 
return value is a Mediumlnt returned from the method. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObj - Pointer to a structure of type Object. 

Return Value 

The return value of BlkExecuteRetlnt is a Mediumlnt returned from the 
method executed. 

Notes 

[pBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkExecuteRetlnt function. 
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BlkExecuteRetFuncPtr 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

PMTH BlkExecuteRetFuncPM pBlk, pObi ) 

PBLK pBlk; F 1 

POBJ pObj; 

Public Function 

Purpose 

The BlkExecuteRetFuncPtr function executes the method in the Block pBlk and 
passes parameters to it. The first parameter passed will be the Object pObj. The 
return value is a Method pointer returned from the method. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObj - Pointer to a structure of type Object. 

Return Value 

The return value from the BlkExecuteRetFuncPtr function is a Method pointer 
returned from the method executed. 

Notes 

[pBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkExecuteRetFuncPtr function. 
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BlkExecuteRetDataPtr 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Void BlkExecuteRetDataPtr( pBlk, pObi ) 

PBLK pBlk; 
POBJ pObj; 

Public Function 

Purpose 

The BlkExecuteRetDataPtr function executes the method in the Block pBlk and 
passes any parameters to it. The first parameter passed will be the Object pObj. 
The return value is a data pointer (Void *) returned from the method. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObj - Pointer to a structure of type Object 

Return Value 

No return value 

Notes 

The return value from the BlkExecuteRetDataPtr function is a data pointer 
(Void *) returned from the method executed. 

[pBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkExecuteRetDataPtr function. 
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BlkExecuteRetBool 



Summary 

#lnclude "cobjects.h" 
#include "blkmac.h" 

Bool BlkExecuteRetBooK pBlk, pObi ) 

PBLK pBlk; 
POBJ pObj; 

Public Function 

Purpose 

The BlkExecuteRetBool function executes the method in the Block pBlk and 
passes any parameters to it. The first parameter passed will be the Object pObj. 
The return value is a Bool returned from the method. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObj - Pointer to a structure of type Object. 

Return Value 

The return value from the BlkExecuteRetBool function is a boolean 
(True/False) value returned from the method executed. 

Notes 

[pBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkExecuteRetBool function. 
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BlkExecute 



Summary 

#toclude "cobjects.h" 
#include "blkmac.h" 

Void BlkExecute(pBlk,pObi) 
PBLK pBlk; 
POBJ pObj; 

Public Function 

Purpose 

The BlkExecute function executes the method in the Block pBlk and passes 
any parameters to it. The first parameter passed will be the Object pObj. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObj - Pointer to a structure of type Object. 

Return Value 

No return value 

Notes 

[pBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkExecute function. 
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BlkDelnit 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Void BlkDelnit(pBlk) 
PBLK pBlk; 

Public Function 

Purpose 

The BlkDelnit function deinitializes the Block pBlk. It should be the last call 
referencing pBlk before deallocating it. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkDelnit function. 
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BlkClear 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Void BlkClear(pBlk) 
PBLK pBlk; 

Public Function 

Purpose 

The BlkClear function clears the parameters of the Block pBlk. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkClear function. 
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Class Reference for Block 



Structure Name: Block 

Abbreviation: Blk 

Class Type: Primitive Class 
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C+0 Datatypes 



Name 




uenniuon 


Reg2 


N/A 




ncyu 


M/A 
N/A 


register 


Reg4 


N/A 


icyisier 


Rea5 


M/A 
IN/A 


register 


Smalllnt 


1 


char 


Str 

Oil 


4 

1 


char 


Qfrinn 
oil lily 


1 


char 


Task 
f adA 


24/32 


struct Task 


Tre 


16/32 


ctnirt TrPfi 

Oil UVrfl IIEC 


Tree 


16/32 


struct Tree 


True 


N/A 


((Bool)1) 


Tsk 


24/32 


struct TasA- 


ULargelnt 


4 


unsigned long 


UMediumlnt 


2 


unsigned int 


USmalllnt 


1 


unsigned char 


Vertex 


22/44 


struct Vertex 


Void 


N/A 


void 


Volatile 


N/A 


volatile 


Vtx 


22/44 


struct Vertex 



Usage 



Prioritized register allocation 
Prioritized register allocation 
Prioritized register allocation 
Prioritized register allocation 
Integers in range [-127:+127] 
Text data 
Text data 
Task class 
Tree class 
Tree class 
Boolean True 
Task class 

Integers in the range [0:OxFFFFFFFF] 
integers in the range [0:0xFFFF] 
Integers in range [0:0xFF] 
Vertex class 
Function declarations 

(default) Identifies function parameters which are modified 
Vertex class 
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C+0 Datatypes 



Name 


Size 


Definition 


Usage 


Mem 


1 


char 


Memory class 


Memory 


1 


char 


Memory class 


Message 


12/22 


struct Message 


Message class 


MetaClass 


20/20 


struct MetaClass 


MetaClass class 


MetaMessage 


8/14 


struct MetaMessage 


MetaMessage class 


MetaSuperClass 


12/22 


struct MetaSuperClass 


MetaSuperClass class 


Method 


2/4 


Void 0( POBJ, ...) 


Function pointer (see S/ocfc) 


MethodRetBool 


2/4 


Bool 0( POBJ, ...) 


Function (returning Bool) pointer (see 6/oc*) 


MethodRetlnt 


2/4 


MediumlntO( POBJ, ...) 


Function (returning Mediumlnt) pointer (see flfoc/c) 


MethodRetOataPtr 


2/4 


PMEM (*)(POBJ,...) 


Function (returning data pointer) pointer (see Block) 


MethodRetFuncPtr 


2/4 


PMTH (*)( POBJ, ...) 


Function (returning function pointer) pointer (see Block) 


MethodRetPtr 


2/4 


Void * f)( POBJ, ... ) 


Function (returning pointer) pointer (see Block) 


Mms 


8/14 


struct MetaMessage 


MetaMessage class 


MODULE_NAME 


N/A 


_FILE_ 


Name of file being compiled 


Msc 


12/22 


struct MetaSuperClass 


MetaSuperClass class 


Msg 


12/22 


struct Message 


Message class 


NULL 


2/4 


0 


Used to assign or return null pointers 


Obj 


2/4 


struct Object 


Ob/'ec/ class 


Object 


2/4 


struct Object 


Object class 


PBLK 


2/4 


struct S/oc/c * 


6/oc/c pointer - does not require structure definition 


PCIO 


2/4 


struct ConsolelnputOutput * 


ConsolelnputOutput pointer - does not require structure 








definition 


PCLS 


2/4 


struct Class* 


Class pointer - does not require structure definition 


POLL 


2/4 . 


struct Ust* 


Ust pointer - does not require structure definition 


PDPA 


2/4 


struct DynamicArray* 


DynamicArray pointer - does not require structure 








definition 


PEDG 


2/4 


struct Etfge * 


Edge pointer - does not require structure definition 


PGRF 


2/4 


struct Graph * 


Graph pointer - does not require structure definition 


PJUL 


2/4 


struct JulianTime * 


JulianTime pointer - does not require structure definition 


PLEL 


2/4 


struct ListElement* 


ListElement pointer - does not require structure definition 


PMCL 


2/4 


struct MetaClass* 


MetaClass pointer - does not require structure definition 


PMEM 


2/4 


Char* 


Mem pointer - does not require structure definition 


PMMS 


2/4 


struct MetaMessage * 


MetaMessage pointer - does not require structure definition 


PMSC 


2/4 


struct MetaSuperClass * 


MetaSuperClass pointer - does not require structure 








definition 


PMSG 


2/4 


struct Message * 


Message pointer - does not require structure definition 


PMTH 

r IVI 1 n 




VQIU \ Jl rVJDJ, ... J 


runcuon pointer (see diock) 


POBJ 


2/4 


struct Object* 


Object pointer - does not require structure definition. Also 








synonymous with a class pointer of unknown type 


PSTR 


2/4 


char* 


Null terminated text strings 


PTRE 


2/4 


struct free * 


Tree pointer - does not require structure definition 


PTSK 


2/4 


struct Task * 


Task pointer - does not require structure definition 


PVTX 


2/4 


struct Vertex * 


Vertex pointer - does not require structure definition 


Real 


8 


double 


Floating point (no range specified) 


Regl 


N/A 


register 


Prioritized register allocation 
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C+O Datatypes 



Name 


Size 


Definition 


Usage 


Blk 


20/38 


struct Btodc 


0/oc/cdass 


Block 


20/38 


struct Block 


fi/oc/c class 


Bool 


1 


char 


Boolean values: True or False 


Call 


N/A 


(Void) 


Overrides* function returning value 


Char 


1 


char 


Text data 


Chr 


1 


char 


Text data 


Class 


16/26 


struct Class 


Class class ! 


ClientPtr 


2/4 


Void* 


Data pointer to unknown type 


CIs 


16/26 


struct Class 


Class class 


Const 


N/A 


const 


Identifies function parameters which are not modified 


DateFormat 


2 


enum DateFormat 


Describe a display format for dates (see JulianTime and 


Dll 






Strina) 


6/12 


struct List 


List class 


Dpa 


8/10 


struct DynamicArray 


DynamicArray class 


DynamicArray 


8/10 


struct DynamicArray 


DynamicArray class 


Edg 


26/52 


struct Edge 


Edge class 


Edge 


26/52 


struct Edge 


Edge class 


ExceptionType 


2 


enum ExceptionType 


Type of exception generated (see Task) 


ExcFilter 


2/4 


Bool O(PTSK) 


Function pointer to exception filters (see Task} 


Ext 


2 


enum ExceptionType 


Type of exception generated 


False 


N/A 


((Bool)0) 


Boolean False 


Flags8 


1 


unsigned char 


Bitflags (8) 


Flags 16 


2 


unsianpH short 


Rit flarK Mft 
uti nays \ i 0/ 


Flags32 


4 


unsigned char 


Bit flags (32) 


GenericPtr 


2/4 


Void* 


Data pointer to unknown type 


Graph 


30/48 


struct Graph 


Graph class 


Grf 


30/48 


struct Graph 


Graph class 


IntAddress 


2/4 


int / long 


Integer capable of holding a data address 


Jul 


4 


struct JulianTime 


JulianTime class 


JulianTime 


4 


struct JulianTime 


JulianTime class 


LARGE DATA PTRS 


N/A 


N/A 


Defined if 4 byte data pointers are the default 


LARGE_FUNC_PTRS 


N/A 


N/A 


Defined if 4 byte function pointers are the default 


Large Int 


4 


long 


Integers in the range [-2147483647:2147483647] 


Lei 


8/16 


struct UstElement 


UstElement class 


LINE_NO 


N/A 


_LINE_ 


Line number in file being compiled 


List 


6/12 


struct List 


Ust class 


UstElement 


8/16 


struct UstElement 


UstElement class 


Mcl 


20/30 


struct MetaClass 


MetaClass class 


Medium Int 


2 


int 


Integers in range [-3276732767] 
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Quick Reference Guide to Classes 



Function Name Description Page Scope Macro 



VtxGetRrstln 


Return first incoming edge 


Vtx-22 


Public 




Y 


vtxGetrirstOut 


Return first outgoing edge 


Vtx - 23 


Public 




Y 


VtxGetGrf 


Return graph 


Vtx-24 


Friend 




Y 


VtxInGrf 


Is vertex in graph 


Vtx -26 


Public 




Y 


Vtxlnit 


Initialize the Vertex object 


Vtx- 25 


Public 




N 


VtxSendDestroy 


Send message for vertex destruction 


Vtx -27 


Public 




N 


VtxStackSetup 


Set up values for topsort 


Vtx -28 


Friend 




Y 


VtxVisitEdge 


Visit function: each edge 


Vtx -29 


Friend 




N 


VtxVisitEdgeClient 


Visit function: each edge 


Vtx -31 


Public 




N 


VtxVisitlnEdge 


Visit function: incoming edge 


Vtx -33 


Friend 




N 


VtxVisitlnEdgeClient 


Visit function: incoming edge 


Vtx -35 


Public 




N 


VtxVisitOutEdge 


Visit function: outgoing edge 


Vtx -37 


Friend 




N 


VtxVisitOutEdgeaient 


Visit function: outgoing edge 


Vtx -39 


Public 




N 
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Function Name 



TskBasicAssert 

TskCondition 

TskDelnit 

TskDetauItlnit 

TskExit 

TskExitWithMsg 

TskGetArgc 

TskGetArgv 

TskGetExceptionCondition 

TskGetExceptionFileName 

TskGetExceptionUneNo 

TskGetExceptionType 

Tsklnit 

Tsklslniiialized 

TskLogCond 

TskMainLogCond 

TskMainPreCond 

TskMainPtrCond 

TskMainRaiseException 

TskNormalExit 

TskOnException 

TskPopExceptionHandier 

TskPreCond 

TskPrintException 

TskPropagateException 

TskPtrCond 

TskPushExh 

TskRaiseException 



Description 



Foundation function 
Raise exception conditionally 
Deinitialize instance 
Initialize instance with defaults 
Exit program with code 
Exit program and print message 
Get main() argument count 
Get main() argument vector 
Return exception condition 
Return filename of exception 
Return exception line number 
Return exception type 
Initialize instance 
Is the Task initialized 
Raise exception conditionally 
Raise exception conditionally 
Raise exception conditionally 
Raise exception conditionally 
Raise exception unconditionally 
Exit task normally 
Establish exception handler 
Pop exception handler 
Raise exception conditionally 
Print description of exception 
Pass last exception 
Raise exception conditionally 
Push the exception 
Raise exception unconditionally 



Page 


Scope Macro 


N/A 


undoc 


N 


Tsk -2 


Public 


N 


Tsk -4 


Public 


N 


Tsk -5 


Public 


N 


Tsk -6 


Public 


N 


Tsk-7 


Public 


N 


Tsk -8 


Public 


N 


Tsk -9 


Public 


N 


Tsk • 10 


O. .UK. 

Public 


N 


Tsk -11 


Public 


N 


Tsk - 12 


Public 


N 


Tsk -13 


Public 


N 


Tsk - 15 


Public 


N 


N/A 


Undoc 


N 


Tsk -17 


Public 


N 


Tsk • 19 


Public 


N 


Tsk -21 


Public 


N 


Tsk -23 


Public 


N 


Tsk -25 


Public 


N 


Tsk -27 


Public 


N 


Tsk -28 


Public 


N 


Tsk -30 


Public 


N 


Tsk -32 


Public 


N 


Tsk -34 


Public 


N 


Tsk -36 


Public 


N 


Tsk -38 


Public 


N 


N/A 


Undoc 


N 


Tsk -40 


Public 


N 



VtxAsGrfLel 

VtxAslnDII 

VtxAsObj 

VtxAsOutDI! 

VtxClear 

VtxConnectToGrf 

VtxCountln 

VtxCountOut 

VtxDelnit 

VtxDestroy 

VtxDisconnectFromGrf 
VtxFindOutEdg 
VtxFindOutEdgClient 
VtxGetClient 



Return list element in graph 

Return vertex as list of incoming edges 

Return edge as object 

Return vertex as list of outgoing edges 

Clear vertex 

Connect vertex to graph 

Count incoming edges 

Count outgoing edges 

Deinitialize the Vertex object 

Deinitialize Vertex object and free space 

Disconnect vertex from graph 

Visit search function: outgoing edges 

Visit search function: outgoing edges 

Return client of vertex 



Vtx-2 


Friend 


Y 


Vtx-3 


Friend 


N 


Vtx-4 


Private 


N 


Vtx-5 


Friend 


N 


Vtx-6 


Public 


N 


Vtx-7 


Public 


N 


Vtx-9 


Public 


Y 


Vtx-11 


Public 


Y 


Vtx-13 


Public 


N 


Vtx-14 


Public 


N 


Vtx-15 


Public 


Y 


Vtx-17 


Private 


N 


Vtx-19 


Public 


N 


Vtx-21 


Public 


Y 
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Function Name 


Description 


Paae 


Scope Macro 


TreClientVisitLeaves 


Visit function: leaves 


Tre - 47 


Public 


N 


TreClientVisitParents 


Visit function: nearest parents first 


Tre - 49 


Public 


N 


TreClientVisitPreOrder 


Visit function: pre-order 


Tre - 51 


Public 


N 


TreClientVisitRange 


Visit function: range 


Tre - 53 


Puhlir 


M 

n 


TreClientVisitSuccPreOrder 


Visit function: all successors 


Tre - 55 


Public 


N 


TreClientVisitSuccessors 


Visit function: successors 


Tre - 57 


Puhlir 


N 


TreCutChildren 


Cut children from tree 


Tre - 59 


Puhlir 


v 
I 


TreCutRange 


Cut node(s) from tree 


Tre - 61 

I Iw W 1 


Piihlir 

r uuiiw 


v 

T 


TreDelnit 


Deinitialize Tree object 


Tre -63 

1 Iw VM 


Puhlir 

r uuiiw 


M 

11 


TreDestroy 


Deinitialize Tree obiect and free snacp 




Puhlir 

1 UUllw 




TreDestroyChildren 


Oestrov anv children of a tre 

fc^wwliVJ vil 1 J wltllvllwll VI Q Uu 


Tra - 65 


Puhlir 


M 
ii 


TreFirstChild 


Return first child 

1 IWIUI II III Wi Wl IHVI 


lit* DO 


r iivaie 


Y 


TreHasChildren 


Does node have anv chilrirpn 


Trp - 68 

1 ie 00 


Puhlir 
ruuuw 


Y 
T 


TreHasSiblings 


Does node have anv ^iblinas 

wvww I iWVJw 1 luiv CU If GIUI 1 1 lug 


Trp - 6Q 

IIC US' 


Pi ihlir 


v 

T 


Trelnit 


Initialize tree obiect 


Trp - 70 
lie* /u 


Pi ihlir 


M 
ri 


TrelsChild 


Does the node have a oarent 


Trp - 71 

1 Iw /I 


Puhlir 


Y 
i 


TrelsDirectAncestor 


Is node a direct ancester 

1 W t IWW W Wj Vll VUl Ul ivvwlvl 


Tre -72 

1 Iw f £ 


Puhlir 

1 UUIiw 


M 
ii 


TrelsRoot 


Does the node have no narpnt 

w^v/ww uiv iiwwu iiufw i iv/ will 


Trp - 71 

IIC / w 


Public 


Y 


TreLastChild 


Return last child 

* *V IUI 1 f iwtwt Wi uiv 


Trp -74 

1 1 C / *T 


Privatp 
ri ivaie 


Y 


TreLastLeaf 


Return last leaf 


Tre - 76 

1 1 w / U 


PrivatP 
r nvaie 


M 
ii 


TreNext 


Return next node 


Tre - 78 

1 Iw t \J 


r iivaie 


Y 

T 


TreNextPreOrder 


Return next node PreOrderly 


Tre - 80 


r ii vale 


M 
ii 


TreNextUnde 


Return next uncle 


Tre - 82 

1 1 v MC 


Privatp 
n ivaie 


ii 


TreParent 


Return Darent node 

1 »W IUI 1 » l/UI Wl l| 1 IVUW 


Trp - 84 


rnvaie 


Y 

T 


TrePasteRangeAfterSibling 


Paste ranae of siblinas 


Trp - fifi 
i ie oo 


Puhlir 


Y 

T 


TrePasteRangeBeforeSibling 


Paste ranae of siblinas 


Trp - 88 
lie oo 


Pi ihlir 
ruuiiw 


Y 

T 


TrePasteRangeRrstChild 


Paste children 


Trp - Q0 

1 Iw *7v 


Pi ihlir 
ruuiiw 


Y 

T 


TrePasteRangeLastChild 


Paste children 

■ UwlV vl IHUI VI 1 


Trp - Qp 
i ie <sc 


Puhlir 

r uuiiw 


Y 

T 


TrePrev 


Return Drevious node 


Trp - Q4 
lie J?** 


Private 
n ivaie 


Y 
i 


TrePrevPreOrder 


Return Drevious nodp PrpOrriprlv 

■ iw iui ii pi viivuw i ii/ ww i icv/iuviiy 


Trp - Q6 
i ie uo 


Privatp 

1 IIVQlw 


N 
ii 


TreSendDestroy 


Send messaae for tree dp<tirurtinn 

Wwl »w uivwwB^C Ivl U ww UwOU UwUwl 1 


Trp - Q8 

IIC 570 


Puhlir 

1 UUItw 


N 
ii 


TreVisitBranchlnOrder 


Visit function* branch in-order 

"wi* iwi iwuwiii lyi ui iwi i III VlUwl 


Trp - QQ 

1 IC *7*7 


Pri watp 

r uvaic 


ii 


TreVisitChildren 


Visit function: children 


Tre - 101 

1 1 w Iwi 


Private 
r I ivaie 


ii 


TreVisitChildrenBwd 


Visit function: children 


Tre - 103 

1 Iw 1 \J\J 


Private 


N 


TreVisitDescBranchlnOrder 


Visit function: descendents 


Tre - 105 

IIC 1 uj 


Private 


N 


TreVisitDesclnOrder 


Visit function* descendents 

• »wu iwi ivuvi wwwwwi iwv " I Iw 


Tre - 107 

tic iv/ 


Private 


N 


TreVisitDesclnOrderBwd 


Visit function* descendents 

» IWH IWI IVUVI la WW WWW 1 lUVl 11 W 


Trp - 1 0Q 

ne wj? 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre- 111 


Private 


N 


Tre Visit InOrdpr 

IIOi 1 Oil 11 IvIUwl 


\/icit fiin/^tinn* in nrHar 

visu luncuon. in-ciuer 


ire - 113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre -115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre-117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre- 119 


Private 


N 


TreVisitPreOrder 


Visit function: pre-order 


Tre -121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre -123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre-125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre-127 


Private 


N 
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ObjSendMessage 


Send message to object 


Obj-21 


Public 


N 


ObjSendMessageReturnlnt 


Send message to object, return Int 


Ob] - 22 


Public 


N 


ObjSendMessageRetumPtr 


Send message to object return pointer 


Obj-23 


Public 


N 



StrBasicExtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract string as specified 


Str-2 


Public 


N 


StrFromDate 


Fill string with a date 


Str-4 


Public 


N 


StrFromMediumlnt 


Integer to string 


Str-6 


Public 


N 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Sir- 11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToLower 


Change case of string to lower 


Str-17 


Public 


Y 


StrToMediumlnt 


String to integer 


Str-19 


Public 


N 


StrToUpper 


Change case of string to upper 


Str-21 


Public 


Y 



TreAsDII 


Return node as list 


Tre 


-2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre 


-3 


Private 


Y 


TreAsObj 


Return node as object 


Tre 


-4 


Private 


Y 


TreClear 


Clear the tree 


Tre 


•5 


Public 


N 


TreClient 


Return client of node 


Tre 


-6 


Public 


Y 


TreClientFindChild 


Visit search function: children 


Tre 


-7 


Public 


N 


TreClientFirstChild 


Return first child node as client 


Tre 


-9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre 


•11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre 


-13 


Public 


Y 


TreClientNext 


Return next node as client 


Tre 


-15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre 


-17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre 


-19 


Public 


Y 


TreClientParent 


Return parent node 


Tre 


-21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre 


-23 


Public 


Y 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre 


-25 


Public 


Y 


TreClientVisitBranchlnOrder 


Visit function: branch in-order 


Tre 


-27 


Public 


N 


TreClientVisitChildren 


Visit function: all children 


Tre 


-29 


Public 


N 


TreClientVisitChildrenBwd 


Visit function: all children 


Tre 


-31 


Public 


N 


TreClientVisitDescBranchlnOrder 


Visit function: descendents 


Tre 


-33 


Public 


N 


TreClientVisitDesclnOrder 


Visit function: descendents 


Tre 


-35 


Public 


N 


TreClientVisitDesclnOrderBwd 


Visit function: descendents 


Tre 


-37 


Public 


N 


TreClientVisitDescLeaves 


Visit function: descendents 


Tre 


-39 


Private 


N 


TreClientVisitDescPreOrder 


Visit function: descendents 


Tre 


-41 


Public 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre 


-43 


Public 


N 


TreClientVisitlnOrderBwd 


Visit function: in-order 


Tre 


-45 


Public 


N 



X 
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MmsGetMethod 


Get the method 


Mms« 


•2 


Public 


N 


MmsGetSelector 


Get the name of selector 


Mms< 


•6 


Public 


N 


MrnsGetSuper 


Get name of superclass 


Mms« 


■4 


Public 


N 


MmsPrint 


Display the instance 


Mms< 


•7 


Public 


N 


MmsValidate 


Validate the instance 


Mms< 


•8 


Public 


N 



MscGetMetaClass 


Get the MetaClass 


Msc- 


•3 


Public 


N 


MscGetName 


Get the name of superclass 


Msc« 


2 


Public 


N 


MscGetOffset 


Get offset of superclass 


Msc- 


-4 


Public 


N 


MscPrint 


Display the contents of the MetaSuperClass 


Msc 


•5 


Public 


N 


MscValidate 


Validate that the instance is valid 


Msc 


>6 


Public 


N 



MsgDelnit 


Deinit instance 


Msg-2 


Public 


N 


MsgGetMethod 


Return method 


Msg -4 


Public 


N 


MsgGetOffset 


Return the object offset 


Msg-3 


Public 


N 


MsgGetSelector 


Return selector 


Msg -5 


Public 


N 


Msglnit 


Initialize instanc 


Msg -6 


Public 


N 


MsgPrint 


Print the instance 


Msg -7 


Public 


N 


MsgSend 


Send message to object 


Msg -8 


Public 


N 


MsgSendReturnlnt 


Send message to object, return int 


Msg -9 


Public 


N 


MsgSendReturnPtr 


Send message to object, return pointer 


Msg -10 


Public 


N 


MsgSetSuperOffsetAndMethod 


Override the method 


N/A 


Undoc 


N 



ObjDelnit 


Deinitialize instance 


Obj -2 


Public 


N 


ObjDestroy 


Deinitialize and deallocate object 


Obj -3 


Public 


N 


ObjGetClient 


Return a client 


Obj -4 


Public 


N 


ObjGetClientOrNull 


Return client if non-NULL 


Obj-6 


Public 


N 


ObjGetCIs 


Return class 


Obj -8 


Public 


N 


ObjGetClsName 


Return class name 


Obj -9 


Public 


N 


ObjGetlmmediateClient 


Return immediate client 


Obj - 10 


Public 


N 


ObjGetMethodAndOffset 


Return method and client offset 


Obj -11 


Public 


N 


ObjGetNthSuperObject 


Return nth superobject 


Obj -13 


Public 


N 


ObjGetRootClient 


Get root client 


Obj - 14 


Public 


N 


ObjGetRootClientSize 


Get root object size 


Obj -15 


Public 


N 


ObjGetSize 


Get object size 


Obj -16 


Public 


N 


ObjGetSubObjectOffset 


Return offset to immediate subobject 


Obj -17 


Public 


N 


Objlnit 


Initialize object 


Obj - 18 


Public 


N 


ObjlsRoot 


Return Treu if is root subobject 


Obj -19 


Public 


N 


ObjRespondsToSelector 


Does object understand message? 


Obj -20 


Public 


N 
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LelDestroy 


Deinitialize list element object and free space 


Lei -27 


Public 


N 


LeIGetClient 


Return client 


Lei -28 


Public 


Y 


LeIGetDII 


Return list obiect 


Lei -29 


Friend 


Y 


LeIGetNext 


Return next element 


Let - 30 


Friend 


Y 


LeIGetNthSuccessor 


Return Nth element 


Lei -31 


Friend 


N 


LeIGetPrev 


Return previous element 


Lei -32 


Friend 


Y 


Lellnit 


Is element in list - 


Lei -33 


Public 


N 


LeIPasteRangeAfter 


Append elements(s) to list 


Lei -34 


Public 


N 


LeIPasteRangeBefore 


Insert elements) to list 


Lei -36 


Public 


N 


LelPasteRangeToList 


Insert elements) to list 


N/A . 


Undoc 


N 


LeISendDestroy 


Send message for list element destruction 


Lel-38 


Public 


N 


LeITest 


Test for valid list element 


Lei -39 


Public 


N 


LeIVisitRange 


Visit function for range 


Lei -40 


Private 


N 



MclCreateClass 


Create a class instance 


Mcl-2 


Private 


H 


MclDestroyCIass 


Destroy a class instance 


Mcl-3 


Friend 


N 


MclFindSelector 


Find a selector index given its name 


Mcl-5 


Public 


N 


MclFindSuperClass 


Find the superclass index given its name 


Mcl-6 


Public 


N 


MclGetClassName 


Get the class name 


Md-7 


Public 


N 


MclGetClassSize 


Return the size of a class instance 


Md-8 


Public 


N 


MclGetMessageCount 


Return the number of messages 


Mcl-9 


Public 


N 


MclGetNthMms 


Return the Nth MetaMessage 


Mcl - 10 


Public 


N 


MclGetNthOffset 


Return the Nth Superclass offset 


Mcl-11 


Public 


N 


MclGetNthSuper 


Return the MetaClass 


Mcl - 12 


Public 


N 


MclGetSuperClassCount 


Return the number of superclasses 


Mcl - 13 


Public 


N 


MclPrint 


Print the MetaClass instance 


Mcl -14 


Public 


N 


MclSendCreateClass 


Return a new instance of the MetaClass 


Mcl -15 


Public 


N 


MclSendDestroyClass 


Deallocate an instance of a Class 


Mcl -16 


Public 


N 


MclValidate 


Validate that the instance is valid 


Mcl -17 


Public 


N 


MclValidateMessages 


Validate the MetaMessages 


N/A 


Undoc 


N 


MclValidateSuperClasses 


Validate the MetaSuperClasses 


N/A 


Undoc 


N 



MemClear 


Clears array elements 


Mem 


■2 


Public 


N 


MemCopy 


Copy array elements within the array 


Mem 


•3 


Public 


N 


MemCutNSet 


Delete elements, shift remaining 


Mem 


■5 


Public 


N 


MemDestroy 


Deallocate memory 


Mem 


•6 


Public 


N 


MemDuplicate 


Copy array into another 


Mem 


•7 


Public 


N 


Mem New 


Allocate memory 


Mem 


•8 


Public 


N 


MemPasteNSet 


Expand array, shift remaining 


Mem 


■9 


Public 


N 


MemSetChr 


Set elements to character 


Mem • 


10 


Public 


N 
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JulCopy 


Codv iulian dav 


Jul 


- 14 


Public 


Y 


JulDateStrToJulian 


Date strino to iulian dav 


Jul 


- 16 


Public 


N 


JulOayOfWeek 


Dav number in week 


Jul 


- 18 

1 u 


Puhlir 


v 
i 


JulDayOfYear 


Dav number in vear 

1 IWII1 Wl III JVUI 


Jul 


-20 


Puhlir 


N 


JulDayslnMonth 


Davs in month 


Jul 

wUt 


-22 


Puhlir 


M 


JulDayslnQuarter 


Davs in auarter 


Jul 

WUI 


■ 24 


Puhlir 
r uui ii/ 




JulDayslnYear 


Davs in vpar 


Jul 

JUI 




Pi thlir 


M 
IN 


JulDiff 




Jul 


. 9ft 

CO 


rUUIIC 


V 
T 


JulDiffL 


Davs bplwppn two datps /Innrri 


Jul 


. ^0 

wv 


Pi ihlir 


V 
T 


JuIGetSvstemJulianDav 


wjdlvlll UOlC dg JUHCUI Udj 


ll ll 
UUI 


' OC 


Pi th\\r 
rUUIIO 


M 
IN 


Jullnit 


Spt tn hpninninn of r^jlonHar lannarv 1 1^ft^ 
wci tu ucuj ninny ui uaioiiucu Jaiiucuy I, I jOO 


llll 
Jul 


. 


Pi ihli/* 
rUDlIC 


V 
T 


JullsLeapYear 


Is da tp in Ipan vpar 


Iui 

JUI 


. ^fi 

► oo 


Pi ihlir 
rUUIIvJ 


M 


JullsMaxValue 


Is date maximum julian value 


Jul 


38 


Public 


Y 


Jul Max 


The maximum of two julian dates 


Jul 


•40 


Public 


Y 


JulMin 


The minimum of two julian dates 


Jut - 


■42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul - 


44 


Public 


N 


JulMonthString 


Rll string with month and year 


Jul - 


46 


Public 


N 


JulQuarterString 


Fill string with quarter and year 


Jul - 


48 


Public 


N 


JulSameOayMonth 


Two dates same day and month 


Jul- 


50 


Public 


N 


JulSetMaxDate 


Set date to maximum value 


Jul - 


52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul- 


54 


Public 


N 


JulToDateStr 


Fill date string of specified format 


Jul - 


56 


Public 


N 


JulValidateDate 


Validate date passed as string 


Jul - 


58 


Public 


N 


JulWeekString 


Rll string with day and month 


Jul - 


60 


Public 


N 


JulYearSlring 


Fill string with year 


Jul - 


62 


Public 


N 



LelAsObj 


Return element as object 


Lei -2 


Private 


Y 


LeICIientCount 


Return count for client and successors 


Lei -3 


Public 


N 


LeICIientDII 


Return client of list 


Lei -5 


Public 


Y 


LeICIientRndRange 


Visit search function: range 


Lei -6 


Public 


N 


LeICIientNext 


Return client of next element 


Lei -8 


Public 


Y 


LeICIientPrev 


Return client of previous element 


Lei -9 


Public 


Y 


LeICIientVisitBwd 


Visit function: client and predecessors 


Lei - 10 


Public 


N 


LeICIientVisitFwd 


Visit function: client and successors 


Lei -12 


Public 


■ N 


LeICIientVisitPredecessors 


Visit function: predecessors 


Lei - 14 


Public 


N 


LeICIientVisitRange 


Visit function: range 


Lei • 16 


Public 


N 


LeICIientVisitSuccessors 


visit function: successors 


Lei - 18 


Public 


N 


LeICountRange 


Count elements 


Lei -20 


Public 


N 


LeICut 


Cut element from list 


Lei -22 


Public 


N 


LeICutRange 


Cut element(s) from list 


Lei -24 


Public 


N 


LeICutRangeFromList 


Cut element(s) from list 


N/A 


Undoc 


N 


LeIDelnit 


Oeinitialize list element object 


Lei -26 


Public 


N 
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EdgGetClient 


Return client of edge 


Edg 


•19 


Public 


Y" 


EdgGetGrf 


Return graph 


Edg 


•20 


Friend 


Y 


EdgGetlnVtx 


Return incoming vertex 


Edg 


■21 


Friend 


Y 


EdgGetNextln 


Return next incoming edge 


Edg 


•23 


Friend 


Y 


EdgGetNextOut 


Return next outgoing edge 


Edg 


•25 


Friend 


Y 


EdgGetOutVtx 


Return outgoing vertex 


Edg' 


•27 


Friend 


Y 


EdgGetVertices 


Return vertices to edge 


Edg 


•29 


Public 


Y 


EdgHasVertices 


Does edge have any vertices 


Edg 


•31 


Public 


N 


EdglnGrf 


Is edge in graph 


Edg- 


•32 


Public 


Y 


Edglnit 


Initialize the edge object 


Edg 


•33 


Public 


N 


EdgSendDestroy 


Send message for edge destruction 


Edg- 


•34 


Public 


Y 


EdgUpdatelnVtx 


Replace incoming vertex 


Edg- 


•35 


Public 


N 


EdgUpdateOutVtx 


Replace outgoing vertex 


Edg- 


•37 


Public 


N 



GrfAnyCycles 


Check graph for cycles 


Grf- 


2 


Public 


Y 


GrfAsEdgDII 


Return List of edges 


Grf- 


4 


Friend 


N 


GrfAsObj 


Return graph as object 


Grf- 


5 


Private 


N 


GrfAsVtxDII 


Return List of vertices 


Grf- 


6 


Friend 


N 


GrfBasicTopologicalSort 


Oo topological sort of graph 


N/A 




Undoc 


N 


GrfClear 


Clear the graph 


Grf- 


7 


Public 


N 


GrfCountEdg 


Count edges of graph 


Grf- 


8 


Public 


Y 


GrfCountVtx 


Count vertices of graph 


Grf- 


10 


Public 


Y 


GrfOelnit 


Deinitialize Graph object 


Grf- 


12 


Public 


N 


GrfDestroy 


Deinitialize Graph object and free space 


Grf- 


13 


Public 


N 


GrfDoTopologicalSort 


Do topological sort of graph 


Grf- 


14 


Public 


Y 


GrfFindEdgClient 


Visit search function: edges 


Grf- 


16 


Public 


N 


GrtFindVtxClient 


Visit search function: vertices 


Grf- 


18 


Public 


N 


GrfGetClient 


Return client of graph 


Grf- 


20 


Public 


N 


Grflnit 


Initialize Graph object 


Grf- 


21 


Public 


N 


GrfSendDestroy 


Send message for graph destruction 


Grf- 


22 


Public 


N 


GrfVisitEdgClient 


Visit function: edges 


Grf- 


23 


Public 


N 


GrfVisitVtxClient 


Visit function: vertices 


Grf- 


25 


Public 


N 


GrtVisitVtxClientlnTopOrderBwd 


Visit function: backward topological order 


Grt- 


27 


Public 


N 


GrfVisitVtxClientlnTopOrderFwd 


Visit function: foiward topological order 


Grf- 


29 


Public 


N 



JulAddDays 


Add/subtract days to date 


Jul -2 


Public 


Y 


JulAddDaysL 


Add/subtract days to date (long) 


Jul -4 


Public 


Y 


JulAddMonths 


Add/subtract months to date 


Jul -6 


Public 


N 


JulAddQuarters 


Add/subtract quarters to date 


Jul -8 


Public 


N 


JulAddYears 


Add/subtract years to date 


Jul • 10 


Public 


N 


JulCalendarToJulian 


Day, month, year to julian day 


Jul -12 


Public 


N 



vi 
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Function Name 


Description 


Page 


Scope Macro 


DpaAppend 


Append an element 


Dpa- 


2 


Public 


N 


DpaClear 


Clear dynamic array 


Dpa- 


4 . 


Public 


N 


DpaCount 


Visit function: count True returns 


Dpa- 


5 


Public 


N 


DpaCountRange 


Visit function: range with return checking 


Dpa- 


7 


Public 


N 


DpaDelnit 


Oeinitialize the dynamic array object 


Dpa- 


9 


Public 


N 


DpaDelete 


Delete element(s) 


Dpa- 


10 


Public 


N 


DpaDestroy 


Deinitialize array object and free space 


Dpa- 


12 


Public 


N 


DpaExpand 


Paste Null elements) into array 


Dpa- 


13 


Public 


N 


DpaFind 


Rnd index returning True 


Dpa- 


15 


Public 


N 


DpaRndPtrBwd 


Rnd index with matching pointer 


Dpa- 


17 


Public 


N 


DpaRndPtrFwd 


Rnd index with matching pointer 


Dpa- 


19 


Public 


N 


DpaFindRangeBwd 


Rnd index returning True for range 


Dpa- 


21 


Public 


N 


DpaRndRangeFwd 


Find index returning True for range 


Doa- 


23 


Public 


N 


DpaGetLast 


Return last element in array 


Dpa - 


27 


Public 


N 


DpaGetNth 


Return Nth array element 


Dpa- 


25 


Public 


N 


DpaGetSize 


Return number of elements 


Dpa- 


29 


Public 


N 


Dpalnit 


Initialize the edge object 


Dpa- 


31 


Public 


N 


DpaNewArray 


Create a new array 


Ml A 

IN/A 




unooc 


N 


DpaResize 


Resize the array 


N/A 




Undoc 


N 


DpaSetNth 


Set Nth element of array 


Dpa- 


33 


Public 


N 


DpaSetRegionNull 


Make region of elements Null 


Dpa- 


35 


Public 


N 




oei array size to n elements 


Dpa- 


37 


Public 


N 


OpaShiftDown 


Shift down N elements in array 


Dpa- 


38 


Public 


N 


DpaShiftUp 


Shift up N elements in array 


Dpa- 


40 


Public 


N 


D pa Visit 


Visit function: all elements 


Dpa- 


42 


Public 


N 


DpaVisitClient 


Visit function: all elements 


Dpa- 


44 


Public 


N 


DpaVisitRange 


Visit function: range of elements 


Dpa- 


46 


Public 


N 


DpaVisitRegion 


Visit function: region of elements 


Dpa- 


48 


Public 


N 


DpaVisitSelfAndSuccessors 


Visit function: client and successors 


Dpa- 


50 


Public 


N 



EdgAsGrfLel 


Return graph list element for edge 


Edg-2 


Friend 


Y 


EdgAslnLel 


Return incoming edge list element 


Edg-3 


Friend 


Y 


EdgAsObj 


Return edge as object 


Edg-4 


Private 


N 


EdgAsOutLel 


Return outgoing edge list element 


Edg-5 


Friend 


Y 


EdgClear 


Clear the edge 


Edg-6 


Public . 


N 


EdgComparelnVtx 


Compare incoming vertex 


Edg-7 


Public 


N 


EdgConnectToGrf 


Connect edge to graph 


Edg-9 


Public 


Y 


EdgConnectToVertices 


Connect edge to vertices 


Edg-11 


Public 


N 


EdgDeinit 


Deinitialize the edge object 


Edg-13 


Public 


N 


EdgDestroy 


Deinitialize edge object and free space 


Edg-14 


Public 


N 


EdgDisconnectFromGrf 


Disconnect edge from graph 


Edg-15 


Public 


Y 


EdgDisconnectRomVertices 


Disconnect edge from vertices 


Edg-17 


Public 


N 
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CIsGetSuperClassCount 


Return number of superclasses 


CIs- 


28 


Public 


N 


CIsGetSuperClasslndex 


Return superclass index 


CIs- 


29 


Public 


N 


Clstnit 


Initialize the instance 


CIs- 


30 


Public 


N 


CIslsRoot 


Is instance the root subclass? 


CIs- 


31 


Public 


N 


ClsOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


ClsPrint 


Print the instance 


CIs- 


32 


Public 


N 


CIsSendDestroy 


Send destroy message to instance 


CIs- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIs- 


34 


Public 


N 


CIsSendObjectMessageReturnlnt 


Send object message, returns Medium Int 


CIs- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


CIs- 


38 


Public 


N 


ClsSuperClassOf 


Initialize sub/super relation 


N/A 




Undoc 


N 



DIIAppend 


Append element to list 


Dll -2 


Public 


N 


DllAppendLast 


Make element last 


Dll -4 


Public 


Y 


DIIAsObj 


Return list as object 


Dll -6 


Private 


Y 


DllClear 


Clear the list 


Dll -7 


Public 


N 


DHCut 


Cut one element from list 


Dll -8 


Public 


N 


OllCutChildren 


Cut all elements from list 


Dll -10 


Public 


N 


DIICutRange 


Cut element(s) from list 


Dll -11 


Public 


N 


DIIDelnit 


Oeinitialize list object 


Dll - 13 


Public 


N 


OllOestroy 


Deinitialize list object and free space 


Dll - 14 


Public 


N 


DIIGetCRent 


Return client of list 


Dll -15 


Public 


Y 


DIIGetRrst 


Return first element 


Dll • 16 


Private 


Y 


DIIGetLast 


Return last element 


Dll -17 


Private 


y ; 


DIIGetNth 


Return Nth element 


Dll - 18 


Private 


N 


DIIGetSize 


Get size of list 


Dll • 19 


Public 


N 


Dlllnit 


Initialize list object 


Dll - 20 


Public 


N 


Dll Insert 


Insert element in list 


Dll • 21 


Public 


N 


DIllnsertRrst 


Make element first 


Dll -23 


Public 


Y 


DlllsEmpty 


Return True if list empty 


Dll - 25 


Public 


Y 


OIILelClientCount 


Visit function: count elements conditionally 


Dll - 26 


Public 


N 


OIILelClientRnd 


Visit search function: all elements 


Dll - 28 


Public 


N 


DiiLelClientRrst 


Return client of first element 


Dll -30 


Public 


Y 


OIILelClientGetNth 


Return Nth client 


Dll -31 


Public 


N 


DIILelClientLast 


Return client of last element 


Dll -33 


Public 


Y 


DIILelClientVisitBwd 


Visit function: all elements 


Dll -34 


Public 


N 


DIILelClientVisitFwd 


Visit function: all elements 


Dll -36 


Public 


N 


DIINotifyCutRange 


Cut elements 


Dll -38 


Friend 


N 


DIINotifyPasteRange 


Paste elements 


Dll -39 


Friend 


N 


DIIPasteRangeAfter 


Paste element(s) to list 


Dll -40 


Public 


N 


DIIPasteRangeBefore 


Paste element(s) in list 


Dll - 42 


Public 


N 


DIIPasteRangeRrst 


Paste element(s) to be first in list 


Dll -44 


Public 


Y 


DIIPasteRangeLast 


Paste element(s) to end of list 


Dll -46 


Public 


Y 


DIISendDestroy 


Send message for list destruction 


Dll -48 


Public 


N 
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RlkClpar 

DIIVwIGCU 


Ulcdl inSloJiCc 


DlK 


■ c 


rUDHC 


M 


BlkDelnit 


Deinitialize instance 


Blk 


•3 


Public 


N 


BlkExecute 


Execute method with parameters 


Blk 


■4 


Public 


N 


BlkExecuteRetBool 


Execute the method, return int 


Blk 


■5 


Public 


! N 


BlkExecuteRetDataPtr 


Execute method, return mem pointer 


Blk 


■6 


Public 


I N 


BlkExecuteRetFuncPtr 


Execute method, return function ptr 


Blk - 


•7 


Public 


N 


BlkExecuteRetlnt 


Execute method, return int 


Blk - 


8 


Public 


N 


BlkHasMethod 


Return True if instance has non-NULL method 


Blk 


•9 


Public 


N 


Blklnit 


Initialize instance 


Blk - 


•10 


Public 


N 


BlkPrint 


Print contents of instance 


Blk - 


11 


Public 


N 


BlkPushDataPtr 


Save pointer parameter 


Blk- 


12 


Public 


N 


BlkPushFuncPtr 


Save function pointer parameter. 


Blk- 


13 


Public 


N 


BlkPushLargelnt 


Save Largelnt parameter 


Blk- 


14 


Public 


N 


BlkPushMediumlnt 


Save Mediumlnt parameter 


Blk- 


15 


Public 


N 


BikSetMethod 


Set the function to call 


Blk- 


16 


Public . 


N 



CIsCreateMessages 


Create the Msg instances 


N/A 




Undoc 


N 


ClsCreateObject 


Create a new Object instance 


CIs- 


2 


Public 


N 


ClsCreateSupers 


Create the superclass instances 


N/A 




Undoc 


N 


ClsOeinit 


Deinitialize the instance 


CIS- 


3 


Public 


N 


ClsOestroy 


Deallocate the instance 


CIS- 


4 


Public 


N 


CIsDestroyMessages 


Destroy the messages 


N/A 




Undoc 


N 


CIsDestroyObject 


Deallocate the object instance 


as- 


5 


Public 


N 


CIsDestroySuperClasses 


Destroy the superclasses 


N/A 




Undoc 


N 


CIsRndMsg 


Find message given selector name 


CIs - 


7 


Public 


N 


CIsFindSelectorlndex 


Find index of selector given name 


CIs - 


8 


Public 


N 


CIsFindSuperClass 


Find superclass given name 


CIs- 


10 


Public 


N 


CIsGetMessageCount 


Get number of messages 


CIs- 


11 


Public 


N 


CIsGetMethodAndOffset 


Return method and sub/super offset 


CIs- 


12 


Public 


N 


CIsGetName 


Return name of the instance 


CIs- 


14 


Public 


N 


CIsGetNthMsg 


Get pointer to nth Message 


CIs- 


15 


Public 


N 


CIsGetNthSuperClass 


Get pointer to Nth superclass 


CIs- 


16 


Public 


N 


CIsGetObjectSize 


Return size of an object instance 


CIs- 


17 


Public 


N 


CIsGetOffsetForMsg 


Return sub/super offset of object 


CIs- 


18 


Public 


N 


CIsGetOffsetOfNthSuper 


Return offset of nth superobject 


Os- 


20 


Public 


N 


CIsGetRootSubClass 


Get the root subclass 


CIs- 


22 


Public 


N 


CisGetRootSubObjectOffset 


Return offset of root subobject 


CIs- 


23 


Public 


N 


CIsGetRootSubObjectSize 


Return size of the root subobject 


CIs- 


24 


Public 


N 


CIsGetSize 


Return size of the instance 


CIs- 


25 


Public 


N 


CIsGetSubClass 


Return subclass 


as- 


26 


Public 


N 


CIsGetSubObjectOffset 


Return offset of a subobject 


Cls- 


27 


Public 


N 
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Introduction 



The C+O Reference Manual provides a concise description of each of the 
functions provided in the class library. The User's Guide contains installation, 
tutorial, descriptions of each class, and error messages. It is recommended 
that you begin be reading the User's Guide, then use this manual to learn the 
specifics of a particular function. 
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